@agentdevjs/core 0.1.0

package/dist/chunk-574NG4UB.js

@@ -0,0 +1,1259 @@
+import {
+  __require
+} from "./chunk-DGUM43GV.js";
+
+// src/core/notification.ts
+import { AsyncLocalStorage } from "async_hooks";
+
+// src/core/debug-hub.ts
+import { connect } from "net";
+
+// src/core/types.ts
+function getDefaultUDSPath() {
+  if (process.platform === "win32") {
+    return "\\\\.\\pipe\\agentdev-viewer";
+  }
+  return "/tmp/agentdev-viewer.sock";
+}
+
+// src/core/debug-transport.ts
+function resolveDebugTransportMode() {
+  return process.env.AGENTDEV_DEBUG_TRANSPORT === "claw" ? "claw" : "viewer-worker";
+}
+function getClawRuntimeUrl() {
+  return process.env.AGENTDEV_CLAW_RUNTIME_URL || "http://127.0.0.1:3030";
+}
+
+// src/core/claw-debug-client.ts
+var ClawDebugClient = class {
+  runtimeUrl;
+  processId;
+  projectRoot;
+  sessionByAgentId = /* @__PURE__ */ new Map();
+  pendingSessionByAgentId = /* @__PURE__ */ new Map();
+  constructor(options = {}) {
+    this.runtimeUrl = (options.runtimeUrl ?? getClawRuntimeUrl()).replace(/\/$/, "");
+    this.processId = options.processId ?? String(process.pid);
+    this.projectRoot = options.projectRoot ?? process.cwd();
+  }
+  async ping() {
+    await this.requestJson("/health");
+  }
+  async registerAgent(input) {
+    const sessionId = `${this.processId}:${input.agentId}`;
+    const existing = this.pendingSessionByAgentId.get(input.agentId);
+    if (existing) {
+      return existing;
+    }
+    const pending = (async () => {
+      const registration = {
+        sessionId,
+        runtime: "agentdev",
+        agentName: input.name,
+        projectRoot: input.projectRoot ?? this.projectRoot,
+        metadata: {
+          adapter: "agentdev-debug-hub",
+          agentId: input.agentId,
+          templateMounts: input.templateMounts ?? [],
+          templateEntries: input.templateEntries ?? {}
+        },
+        state: {
+          hookInspector: input.hookInspector ?? null,
+          overview: input.overview ?? null
+        }
+      };
+      await this.requestJson("/api/sessions/register", {
+        method: "POST",
+        body: JSON.stringify(registration)
+      });
+      this.sessionByAgentId.set(input.agentId, sessionId);
+      await this.pushLifecycle(input.agentId, {
+        phase: "agent-registered",
+        agentId: input.agentId,
+        name: input.name
+      });
+      return sessionId;
+    })();
+    this.pendingSessionByAgentId.set(input.agentId, pending);
+    try {
+      return await pending;
+    } finally {
+      this.pendingSessionByAgentId.delete(input.agentId);
+    }
+  }
+  async unregisterAgent(agentId) {
+    await this.pushLifecycle(agentId, {
+      phase: "agent-unregistered",
+      agentId
+    });
+  }
+  async pushMessages(agentId, messages) {
+    await this.pushEvent(agentId, "message", { messages });
+  }
+  async registerTools(agentId, tools) {
+    await this.pushEvent(agentId, "tools", { tools });
+  }
+  async updateInspector(agentId, hookInspector) {
+    await this.pushEvent(agentId, "snapshot", {
+      scope: "hookInspector",
+      hookInspector
+    });
+  }
+  async updateOverview(agentId, overview) {
+    await this.pushEvent(agentId, "snapshot", {
+      scope: "overview",
+      overview
+    });
+  }
+  async updateTodoPlan(agentId, plan) {
+    await this.pushEvent(agentId, "todo-plan", {
+      scope: "todoPlan",
+      plan
+    });
+  }
+  async pushNotification(agentId, notification) {
+    await this.pushEvent(agentId, "notification", { notification });
+  }
+  async requestUserInput(_agentId, request, timeout, signal) {
+    const agentId = _agentId;
+    const requestId = `input-${agentId}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    await this.pushEvent(agentId, "input", {
+      requestId,
+      request,
+      timeout,
+      status: "pending"
+    });
+    const sessionId = await this.requireSessionId(agentId);
+    const startedAt = Date.now();
+    const pollIntervalMs = 400;
+    while (true) {
+      if (signal?.aborted) {
+        throw this.createAbortError(`User input request for Agent '${agentId}' was cancelled`);
+      }
+      if (timeout !== Infinity && Date.now() - startedAt > timeout) {
+        throw new Error(`User input timeout after ${timeout}ms`);
+      }
+      let response;
+      try {
+        response = await fetch(
+          `${this.runtimeUrl}/api/agents/${encodeURIComponent(sessionId)}/input-response?requestId=${encodeURIComponent(requestId)}`,
+          { signal }
+        );
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Unable to reach Claw runtime at ${this.runtimeUrl} while waiting for user input: ${message}`);
+      }
+      if (response.ok) {
+        const body = await response.json();
+        return body.response;
+      }
+      if (response.status !== 404) {
+        const text = await response.text();
+        throw new Error(`Input bridge request failed: ${response.status} ${response.statusText} ${text}`);
+      }
+      await this.delay(pollIntervalMs, signal);
+    }
+  }
+  delay(ms, signal) {
+    if (signal?.aborted) {
+      return Promise.reject(this.createAbortError("Operation was cancelled"));
+    }
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        signal?.removeEventListener("abort", onAbort);
+        resolve();
+      }, ms);
+      const onAbort = () => {
+        clearTimeout(timer);
+        reject(this.createAbortError("Operation was cancelled"));
+      };
+      signal?.addEventListener("abort", onAbort, { once: true });
+    });
+  }
+  createAbortError(message) {
+    const error = new Error(message);
+    error.name = "AbortError";
+    return error;
+  }
+  async pushLifecycle(agentId, payload) {
+    await this.pushEvent(agentId, "lifecycle", payload);
+  }
+  async pushEvent(agentId, kind, payload) {
+    const sessionId = await this.requireSessionId(agentId);
+    const event = {
+      sessionId,
+      kind,
+      payload
+    };
+    await this.requestJson("/api/events", {
+      method: "POST",
+      body: JSON.stringify(event)
+    });
+  }
+  async requireSessionId(agentId) {
+    const sessionId = this.sessionByAgentId.get(agentId);
+    if (!sessionId) {
+      const pending = this.pendingSessionByAgentId.get(agentId);
+      if (pending) {
+        return pending;
+      }
+      throw new Error(`No Claw session registered for agentId '${agentId}'`);
+    }
+    return sessionId;
+  }
+  async requestJson(path, init) {
+    let response;
+    try {
+      response = await fetch(`${this.runtimeUrl}${path}`, {
+        ...init,
+        headers: {
+          "content-type": "application/json",
+          ...init?.headers ?? {}
+        }
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      throw new Error(`Unable to reach Claw runtime at ${this.runtimeUrl}: ${message}`);
+    }
+    if (!response.ok) {
+      const body = await response.text();
+      throw new Error(`Claw runtime request failed: ${response.status} ${response.statusText} ${body}`);
+    }
+    if (response.status === 204) {
+      return null;
+    }
+    return response.json();
+  }
+};
+
+// src/core/debug-capabilities.ts
+function getDebugCapabilities() {
+  const transportMode = resolveDebugTransportMode();
+  const isClaw = transportMode === "claw";
+  return {
+    transportMode,
+    interactiveInput: true,
+    runtimeUrl: isClaw ? getClawRuntimeUrl() : null,
+    viewerCompatibleApi: isClaw,
+    debuggerMcpMetadata: isClaw
+  };
+}
+
+// src/core/debug-hub.ts
+var DebugHub = class _DebugHub {
+  static instance;
+  transportMode;
+  clawClient;
+  // ========== 状态 ==========
+  agents = /* @__PURE__ */ new Map();
+  nextId = 1;
+  processId;
+  // 进程唯一标识
+  // 输入请求回调映射：requestId → owned request lifecycle
+  pendingInputRequests = /* @__PURE__ */ new Map();
+  interruptHandlers = /* @__PURE__ */ new Map();
+  globalInterruptHandler;
+  // 活跃的输入请求元数据（用于重连恢复）：agentId → requestInfo
+  activeInputRequests = /* @__PURE__ */ new Map();
+  // UDS 客户端连接
+  udsClient;
+  udsPath;
+  workerReadBuffer = "";
+  workerPort = null;
+  clientReady = false;
+  stopped = false;
+  /** Shared connection barrier for every Agent hosted by this process. */
+  connectionPromise;
+  /** headless 运行时（无 ViewerWorker）下每类消息只告警一次，避免刷屏。 */
+  sendToWorkerWarnedTypes = /* @__PURE__ */ new Set();
+  // 注册锁（防止并发竞争）
+  registrationLock = false;
+  // 重连机制
+  reconnectTimer;
+  reconnectAttempts = 0;
+  MAX_RECONNECT_ATTEMPTS = 10;
+  RECONNECT_DELAY = 2e3;
+  // 缓存每个 Agent 的模板装载载荷（mounts + entries，用于重连后重新注册）
+  agentTemplatePayload = /* @__PURE__ */ new Map();
+  // 缓存每个 Agent 的外部输入策略（用于重连后重新注册）
+  agentInputPolicy = /* @__PURE__ */ new Map();
+  // ========== 单例 ==========
+  constructor() {
+    this.udsPath = process.env.AGENTDEV_UDS_PATH || getDefaultUDSPath();
+    this.processId = String(process.pid);
+    this.transportMode = resolveDebugTransportMode();
+    if (this.transportMode === "claw") {
+      this.clawClient = new ClawDebugClient({
+        processId: this.processId,
+        projectRoot: process.cwd()
+      });
+    }
+  }
+  static getInstance() {
+    if (!_DebugHub.instance) {
+      _DebugHub.instance = new _DebugHub();
+    }
+    return _DebugHub.instance;
+  }
+  /**
+   * 为 Agent 分配进程内稳定且唯一的运行时 ID。
+   * 分配不等于注册；同一 ID 可在后续 Viewer attach/re-attach 时复用。
+   */
+  allocateAgentId() {
+    return `agent-${this.nextId++}-${this.processId}`;
+  }
+  // ========== 公开 API ==========
+  /**
+   * 启动调试服务器
+   * @param port HTTP 端口（默认 2026，仅用于显示）
+   * @param openBrowser 是否自动打开浏览器（默认 true，已废弃参数）
+   */
+  async start(port = 2026, openBrowser = true) {
+    if (this.clientReady) return;
+    if (this.connectionPromise) return this.connectionPromise;
+    const pending = this.startInternal(port, openBrowser);
+    this.connectionPromise = pending;
+    try {
+      await pending;
+    } finally {
+      if (this.connectionPromise === pending) {
+        this.connectionPromise = void 0;
+      }
+    }
+  }
+  async startInternal(port, openBrowser) {
+    this.stopped = false;
+    if (this.transportMode === "claw") {
+      this.workerPort = port;
+      try {
+        await this.clawClient?.ping();
+        this.clientReady = true;
+        console.log(`[DebugHub] \u5DF2\u8FDE\u63A5\u5230 Claw runtime: ${getClawRuntimeUrl()}`);
+      } catch (err) {
+        console.warn(`[DebugHub] \u65E0\u6CD5\u8FDE\u63A5\u5230 Claw runtime: ${err.message}`);
+        console.warn("[DebugHub] \u8C03\u8BD5\u529F\u80FD\u5C06\u88AB\u7981\u7528\u3002\u8BF7\u5148\u542F\u52A8 AgentDevClaw runtime\u3002");
+        this.clientReady = false;
+        throw err;
+      }
+      return;
+    }
+    this.workerPort = port;
+    this.openBrowser = openBrowser;
+    try {
+      await this.connectToWorker();
+      console.log(`[DebugHub] \u8C03\u8BD5\u670D\u52A1\u5668\u5DF2\u8FDE\u63A5: http://localhost:${port}`);
+    } catch (err) {
+      console.log(`[DebugHub] ViewerWorker \u672A\u8FD0\u884C\uFF0C\u6B63\u5728\u81EA\u52A8\u542F\u52A8...`);
+      try {
+        await this.spawnViewerWorker();
+        await new Promise((resolve) => setTimeout(resolve, 1e3));
+        await this.connectToWorker();
+        console.log(`[DebugHub] \u8C03\u8BD5\u670D\u52A1\u5668\u5DF2\u8FDE\u63A5: http://localhost:${port}`);
+      } catch (spawnErr) {
+        console.warn(`[DebugHub] \u65E0\u6CD5\u542F\u52A8 ViewerWorker: ${spawnErr.message}`);
+        console.warn(`[DebugHub] \u8C03\u8BD5\u529F\u80FD\u5C06\u88AB\u7981\u7528\u3002\u8BF7\u624B\u52A8\u8FD0\u884C 'agentdev-viewer' \u542F\u52A8\u8C03\u8BD5\u670D\u52A1\u5668\u3002`);
+        this.clientReady = false;
+        throw spawnErr;
+      }
+    }
+  }
+  /**
+   * 自动启动 ViewerWorker 进程
+   */
+  openBrowser = true;
+  viewerWorkerProcess;
+  async spawnViewerWorker() {
+    const { spawn } = await import("child_process");
+    const { existsSync } = await import("fs");
+    const { fileURLToPath } = await import("url");
+    const { dirname, join } = await import("path");
+    let viewerPath;
+    try {
+      const agentdevPath = __require.resolve("agentdev/package.json");
+      viewerPath = join(dirname(agentdevPath), "dist", "cli", "viewer.js");
+    } catch {
+      try {
+        const currentDir = dirname(fileURLToPath(import.meta.url));
+        viewerPath = join(currentDir, "..", "cli", "viewer.js");
+      } catch {
+        viewerPath = "agentdev-viewer";
+      }
+    }
+    if (viewerPath !== "agentdev-viewer" && !existsSync(viewerPath)) {
+      viewerPath = "agentdev-viewer";
+    }
+    return new Promise((resolve, reject) => {
+      try {
+        const env = {
+          ...process.env,
+          AGENTDEV_PORT: String(this.workerPort || 2026),
+          AGENTDEV_OPEN_BROWSER: this.openBrowser ? "true" : "false",
+          AGENTDEV_UDS_PATH: this.udsPath
+        };
+        console.log(`[DebugHub] \u542F\u52A8 ViewerWorker: ${viewerPath}`);
+        const isBinCommand = viewerPath === "agentdev-viewer" || viewerPath === "agentdev-server";
+        const command = isBinCommand ? viewerPath : "node";
+        const args = isBinCommand ? [] : [viewerPath];
+        this.viewerWorkerProcess = spawn(command, args, {
+          env,
+          stdio: ["ignore", "pipe", "pipe"],
+          detached: false,
+          shell: isBinCommand
+          // bin 命令需要 shell 来解析
+        });
+        this.viewerWorkerProcess.on("error", (err) => {
+          console.error("[DebugHub] ViewerWorker \u8FDB\u7A0B\u9519\u8BEF:", err.message);
+          reject(err);
+        });
+        this.viewerWorkerProcess.stdout?.on("data", (data) => {
+          const lines = data.toString().trim().split("\n");
+          for (const line of lines) {
+            console.log(`[ViewerWorker] ${line}`);
+          }
+        });
+        this.viewerWorkerProcess.stderr?.on("data", (data) => {
+          const lines = data.toString().trim().split("\n");
+          for (const line of lines) {
+            console.error(`[ViewerWorker] ${line}`);
+          }
+        });
+        setTimeout(() => {
+          if (this.viewerWorkerProcess && !this.viewerWorkerProcess.killed) {
+            resolve();
+          } else {
+            reject(new Error("ViewerWorker \u8FDB\u7A0B\u542F\u52A8\u5931\u8D25"));
+          }
+        }, 500);
+      } catch (err) {
+        reject(err);
+      }
+    });
+  }
+  /**
+   * 停止调试服务器
+   */
+  stop() {
+    this.stopped = true;
+    if (this.transportMode === "claw") {
+      this.clientReady = false;
+      return;
+    }
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = void 0;
+    }
+    if (this.udsClient) {
+      this.sendToWorker({ type: "stop" });
+      this.udsClient.end();
+      this.udsClient = void 0;
+      this.clientReady = false;
+    }
+  }
+  /**
+   * 手动重连（可选）
+   * 如果已经连接，则不执行任何操作
+   */
+  async reconnect() {
+    if (this.transportMode === "claw") {
+      await this.start(this.workerPort ?? 2026, false);
+      if (!this.clientReady) {
+        throw new Error("Claw runtime reconnect failed");
+      }
+      return;
+    }
+    if (this.clientReady && this.udsClient) {
+      console.log("[DebugHub] \u5DF2\u7ECF\u8FDE\u63A5\uFF0C\u65E0\u9700\u91CD\u8FDE");
+      return;
+    }
+    this.reconnectAttempts = 0;
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = void 0;
+    }
+    try {
+      await this.connectToWorker();
+      console.log("[DebugHub] \u2705 \u624B\u52A8\u91CD\u8FDE\u6210\u529F");
+    } catch (error) {
+      console.error(`[DebugHub] \u624B\u52A8\u91CD\u8FDE\u5931\u8D25: ${error.message}`);
+      throw error;
+    }
+  }
+  /**
+   * 注册 Agent
+   * @param agent Agent 实例
+   * @param name 显示名称（可选，默认使用类名）
+   * @param templateMounts 模板装载点（真实目录根，可选）
+   * @param templateEntries 模板名 → {mount 下标, rel 相对路径}（可选）
+   * @returns 分配的 agentId
+   */
+  registerAgent(agent, name, templateMounts, templateEntries, hookInspector, overview, projectRoot, reservedAgentId, inputPolicy) {
+    while (this.registrationLock) {
+    }
+    this.registrationLock = true;
+    try {
+      const resolvedProjectRoot = projectRoot || process.cwd();
+      const id = reservedAgentId || this.allocateAgentId();
+      const existing = this.agents.get(id);
+      if (existing && existing.agent !== agent) {
+        throw new Error(`Agent ID '${id}' is already registered by another Agent instance`);
+      }
+      const info = {
+        id,
+        name: name || agent.constructor.name,
+        registeredAt: existing?.info.registeredAt ?? Date.now(),
+        projectRoot: resolvedProjectRoot
+      };
+      this.agents.set(id, { info, agent });
+      if (templateMounts || templateEntries) {
+        this.agentTemplatePayload.set(id, {
+          mounts: templateMounts ?? [],
+          entries: templateEntries ?? {}
+        });
+      }
+      if (inputPolicy) {
+        this.agentInputPolicy.set(id, inputPolicy);
+      }
+      if (this.transportMode === "claw") {
+        void this.clawClient?.registerAgent({
+          agentId: id,
+          name: info.name,
+          projectRoot: resolvedProjectRoot,
+          templateMounts: templateMounts ?? [],
+          templateEntries: templateEntries ?? {},
+          hookInspector,
+          overview,
+          inputPolicy: inputPolicy || void 0
+        }).catch((error) => {
+          console.error(`[DebugHub] Claw registerAgent \u5931\u8D25: ${error.message}`);
+        });
+      } else {
+        this.sendToWorker({
+          type: "register-agent",
+          agentId: id,
+          name: info.name,
+          createdAt: info.registeredAt,
+          projectRoot: resolvedProjectRoot,
+          templateMounts: templateMounts ?? [],
+          templateEntries: templateEntries ?? {},
+          hookInspector,
+          overview,
+          inputPolicy: inputPolicy || void 0
+        });
+      }
+      console.log(`[DebugHub] Agent \u5DF2\u6CE8\u518C: ${id} (${info.name})`);
+      return id;
+    } finally {
+      this.registrationLock = false;
+    }
+  }
+  /**
+   * 注销 Agent
+   * @param agentId Agent ID
+   */
+  unregisterAgent(agentId) {
+    this.interruptHandlers.delete(agentId);
+    this.cancelInputRequests(agentId, `Agent '${agentId}' was unregistered`);
+    this.activeInputRequests.delete(agentId);
+    const deleted = this.agents.delete(agentId);
+    if (deleted) {
+      this.agentTemplatePayload.delete(agentId);
+      this.agentInputPolicy.delete(agentId);
+      if (this.transportMode === "claw") {
+        void this.clawClient?.unregisterAgent(agentId).catch((error) => {
+          console.error(`[DebugHub] Claw unregisterAgent \u5931\u8D25: ${error.message}`);
+        });
+      } else {
+        this.sendToWorker({ type: "unregister-agent", agentId });
+      }
+      console.log(`[DebugHub] Agent \u5DF2\u6CE8\u9500: ${agentId}`);
+    }
+  }
+  /**
+   * 推送 Agent 消息
+   * @param agentId Agent ID
+   * @param messages 消息数组
+   */
+  pushMessages(agentId, messages) {
+    if (this.transportMode === "claw") {
+      void this.clawClient?.pushMessages(agentId, messages).catch((error) => {
+        console.error(`[DebugHub] Claw pushMessages \u5931\u8D25: ${error.message}`);
+      });
+      return;
+    }
+    this.sendToWorker({
+      type: "push-messages",
+      agentId,
+      messages
+    });
+  }
+  /**
+   * 注册 Agent 工具
+   * @param agentId Agent ID
+   * @param tools 工具数组
+   */
+  registerAgentTools(agentId, tools) {
+    if (this.transportMode === "claw") {
+      void this.clawClient?.registerTools(agentId, tools).catch((error) => {
+        console.error(`[DebugHub] Claw registerTools \u5931\u8D25: ${error.message}`);
+      });
+      return;
+    }
+    this.sendToWorker({
+      type: "register-tools",
+      agentId,
+      tools
+    });
+  }
+  updateAgentInspector(agentId, hookInspector) {
+    if (this.transportMode === "claw") {
+      void this.clawClient?.updateInspector(agentId, hookInspector).catch((error) => {
+        console.error(`[DebugHub] Claw updateInspector \u5931\u8D25: ${error.message}`);
+      });
+      return;
+    }
+    this.sendToWorker({
+      type: "update-agent-inspector",
+      agentId,
+      hookInspector
+    });
+  }
+  updateAgentOverview(agentId, overview) {
+    if (this.transportMode === "claw") {
+      void this.clawClient?.updateOverview(agentId, overview).catch((error) => {
+        console.error(`[DebugHub] Claw updateOverview \u5931\u8D25: ${error.message}`);
+      });
+      return;
+    }
+    this.sendToWorker({
+      type: "update-agent-overview",
+      agentId,
+      overview
+    });
+  }
+  updateTodoPlan(agentId, plan) {
+    if (this.transportMode === "claw") {
+      void this.clawClient?.updateTodoPlan(agentId, plan).catch((error) => {
+        console.error(`[DebugHub] Claw updateTodoPlan \u5931\u8D25: ${error.message}`);
+      });
+      return;
+    }
+    this.sendToWorker({
+      type: "update-todo-plan",
+      agentId,
+      plan
+    });
+  }
+  /**
+   * 获取所有已注册的 Agent 信息
+   */
+  getAgentList() {
+    return Array.from(this.agents.values()).map((v) => v.info);
+  }
+  isAgentRegistered(agentId) {
+    return this.agents.has(agentId);
+  }
+  getTransportMode() {
+    return this.transportMode;
+  }
+  getCapabilities() {
+    return getDebugCapabilities();
+  }
+  setInterruptHandler(agentIdOrHandler, handler) {
+    if (typeof agentIdOrHandler === "string") {
+      if (handler) {
+        this.interruptHandlers.set(agentIdOrHandler, handler);
+        return () => {
+          if (this.interruptHandlers.get(agentIdOrHandler) === handler) {
+            this.interruptHandlers.delete(agentIdOrHandler);
+          }
+        };
+      } else {
+        this.interruptHandlers.delete(agentIdOrHandler);
+        return () => {
+        };
+      }
+    } else {
+      this.globalInterruptHandler = agentIdOrHandler;
+      return () => {
+        if (this.globalInterruptHandler === agentIdOrHandler) {
+          this.globalInterruptHandler = void 0;
+        }
+      };
+    }
+  }
+  /**
+   * 根据 Agent 实例获取其 ID
+   */
+  getAgentId(agent) {
+    for (const [id, data] of this.agents) {
+      if (data.agent === agent) {
+        return id;
+      }
+    }
+    return void 0;
+  }
+  /**
+   * 获取 Worker 端口
+   */
+  getPort() {
+    return this.workerPort;
+  }
+  /**
+   * 检查是否已连接到 ViewerWorker
+   */
+  isConnected() {
+    if (this.transportMode === "claw") {
+      return this.clientReady;
+    }
+    return this.clientReady && !!this.udsClient;
+  }
+  /**
+   * 推送通知
+   * @param agentId Agent ID
+   * @param notification 通知对象
+   */
+  pushNotification(agentId, notification) {
+    if (this.transportMode === "claw") {
+      void this.clawClient?.pushNotification(agentId, notification).catch((error) => {
+        console.error(`[DebugHub] Claw pushNotification \u5931\u8D25: ${error.message}`);
+      });
+      return;
+    }
+    this.sendToWorker({
+      type: "push-notification",
+      agentId,
+      notification
+    });
+  }
+  /**
+   * 请求用户输入
+   * @param agentId Agent ID
+   * @param prompt 提示信息
+   * @param timeout 超时时间（毫秒），默认 Infinity（无限等待）
+   * @returns Promise<string> 用户输入内容
+   */
+  requestUserInput(agentId, prompt, timeout = Infinity) {
+    return this.requestUserInputEvent(agentId, { prompt }, timeout).then((response) => {
+      if (response.kind !== "text") {
+        throw new Error(`Expected text user input but received action '${response.actionId ?? "unknown"}'`);
+      }
+      return response.text ?? "";
+    });
+  }
+  requestUserInputEvent(agentId, request, timeout = Infinity) {
+    if (this.activeInputRequests.has(agentId)) {
+      return Promise.reject(new Error(`Agent '${agentId}' already has an active user input lease`));
+    }
+    if (this.transportMode === "claw") {
+      if (!this.clawClient) {
+        return Promise.reject(new Error("Claw client is not available"));
+      }
+      const localRequestId = `claw-input-${agentId}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+      const abortController = new AbortController();
+      return new Promise((resolve, reject) => {
+        this.pendingInputRequests.set(localRequestId, {
+          agentId,
+          resolve,
+          reject,
+          abortController
+        });
+        this.activeInputRequests.set(agentId, {
+          requestId: localRequestId,
+          prompt: request.prompt,
+          placeholder: request.placeholder,
+          initialValue: request.initialValue,
+          actions: request.actions,
+          mode: request.mode,
+          questions: request.questions,
+          timestamp: Date.now()
+        });
+        this.clawClient.requestUserInput(agentId, request, timeout, abortController.signal).then((response) => this.settleInputRequest(localRequestId, { response })).catch((error) => this.settleInputRequest(localRequestId, {
+          error: error instanceof Error ? error : new Error(String(error))
+        }));
+      });
+    }
+    const requestId = `input-${agentId}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    return new Promise((resolve, reject) => {
+      const pending = { agentId, resolve, reject };
+      if (timeout !== Infinity) {
+        pending.timer = setTimeout(() => {
+          this.settleInputRequest(requestId, {
+            error: new Error(`User input timeout after ${timeout}ms`)
+          });
+        }, timeout);
+      }
+      this.pendingInputRequests.set(requestId, pending);
+      this.activeInputRequests.set(agentId, {
+        requestId,
+        prompt: request.prompt,
+        placeholder: request.placeholder,
+        initialValue: request.initialValue,
+        actions: request.actions,
+        mode: request.mode,
+        questions: request.questions,
+        timestamp: Date.now()
+      });
+      this.sendToWorker({
+        type: "request-input",
+        agentId,
+        requestId,
+        prompt: request.prompt,
+        placeholder: request.placeholder,
+        initialValue: request.initialValue,
+        actions: request.actions,
+        mode: request.mode,
+        questions: request.questions,
+        timeout
+      });
+    });
+  }
+  // ========== 内部方法 ==========
+  /**
+   * 连接到 UDS 服务器
+   */
+  async connectToWorker() {
+    return new Promise((resolve, reject) => {
+      const socket = connect(this.udsPath);
+      this.udsClient = socket;
+      socket.on("connect", () => {
+        this.workerReadBuffer = "";
+        this.clientReady = true;
+        this.reconnectAttempts = 0;
+        console.log(`[DebugHub] \u5DF2\u8FDE\u63A5\u5230 ViewerWorker: ${this.udsPath}`);
+        this.reregisterAllAgents();
+        resolve();
+      });
+      socket.setEncoding("utf8");
+      socket.on("data", (data) => {
+        this.workerReadBuffer += data;
+        const lines = this.workerReadBuffer.split("\n");
+        this.workerReadBuffer = lines.pop() ?? "";
+        for (const line of lines) {
+          if (!line.trim()) continue;
+          try {
+            const msg = JSON.parse(line);
+            this.handleWorkerMessage(msg);
+          } catch (err) {
+            console.error("[DebugHub] Worker \u6D88\u606F\u89E3\u6790\u5931\u8D25:", err);
+          }
+        }
+      });
+      socket.on("error", (err) => {
+        if (this.udsClient === socket) {
+          this.udsClient = void 0;
+          this.clientReady = false;
+        }
+        reject(new Error(`\u8FDE\u63A5 ViewerWorker \u5931\u8D25 (${this.udsPath}): ${err.message}
+\u8BF7\u5148\u542F\u52A8 ViewerWorker \u670D\u52A1\u5668`));
+      });
+      socket.on("close", () => {
+        this.workerReadBuffer = "";
+        this.clientReady = false;
+        if (this.udsClient === socket) {
+          this.udsClient = void 0;
+        }
+        console.warn("[DebugHub] \u4E0E ViewerWorker \u7684\u8FDE\u63A5\u5DF2\u65AD\u5F00");
+        if (!this.stopped) {
+          this.scheduleReconnect();
+        }
+      });
+    });
+  }
+  /**
+   * 处理来自 Worker 的消息
+   */
+  handleWorkerMessage(msg) {
+    switch (msg.type) {
+      // 处理用户输入响应
+      case "input-response": {
+        if (this.pendingInputRequests.has(msg.requestId)) {
+          this.settleInputRequest(msg.requestId, { response: msg.response ?? {
+            kind: "text",
+            text: msg.input
+          } });
+        } else {
+          console.warn(`[DebugHub] \u672A\u77E5\u8F93\u5165\u54CD\u5E94: ${msg.requestId}`);
+        }
+        break;
+      }
+      // 处理中断信号
+      case "interrupt-agent": {
+        console.log(`[DebugHub] \u6536\u5230\u4E2D\u65AD\u4FE1\u53F7: agentId=${msg.agentId}, knownAgents=[${[...this.agents.keys()].join(",")}]`);
+        const agentData = this.agents.get(msg.agentId);
+        console.log(`[DebugHub] agentData found=${!!agentData}, hasAgent=${!!agentData?.agent}, hasInterrupt=${typeof agentData?.agent?.interrupt}`);
+        let interruptAccepted = false;
+        if (agentData?.agent && typeof agentData.agent.interrupt === "function") {
+          interruptAccepted = agentData.agent.interrupt() === true;
+          console.log(`[DebugHub] agent.interrupt() returned: ${interruptAccepted}`);
+        } else {
+          console.warn(`[DebugHub] Agent \u4E0D\u652F\u6301\u4E2D\u65AD: ${msg.agentId}`);
+        }
+        if (interruptAccepted) {
+          this.cancelInputRequests(msg.agentId, `Agent '${msg.agentId}' was interrupted`);
+        }
+        const specificHandler = this.interruptHandlers.get(msg.agentId);
+        const effectiveHandler = specificHandler ?? this.globalInterruptHandler;
+        if (effectiveHandler) {
+          Promise.resolve(effectiveHandler(msg.agentId, msg.clearQueue === true)).catch((error) => {
+            console.error("[DebugHub] interruptHandler \u6267\u884C\u5931\u8D25:", error);
+          });
+        }
+        break;
+      }
+    }
+  }
+  /**
+   * 重新注册所有 Agent（重连后调用）
+   * 确保 ViewerWorker 能够恢复所有 Agent 的注册信息
+   */
+  reregisterAllAgents() {
+    if (this.transportMode === "claw") {
+      for (const [id, data] of this.agents) {
+        const hookInspector = data.agent.buildHookInspectorSnapshot?.() || data.agent.hookInspector;
+        const overview = data.agent.buildOverviewSnapshot?.();
+        const templatePayload = this.agentTemplatePayload.get(id) || { mounts: [], entries: {} };
+        void this.clawClient?.registerAgent({
+          agentId: id,
+          name: data.info.name,
+          projectRoot: data.info.projectRoot || process.cwd(),
+          templateMounts: templatePayload.mounts,
+          templateEntries: templatePayload.entries,
+          hookInspector,
+          overview,
+          inputPolicy: this.agentInputPolicy.get(id) || void 0
+        }).then(async () => {
+          const tools = data.agent.tools;
+          if (tools && typeof tools.getEntries === "function") {
+            const entries = tools.getEntries();
+            const toolList = entries.map((e) => e.tool);
+            if (toolList.length > 0) {
+              await this.clawClient?.registerTools(id, toolList);
+            }
+          }
+          const context = data.agent.getContext?.();
+          if (context && typeof context.getAll === "function") {
+            const messages = context.getAll();
+            if (messages.length > 0) {
+              await this.clawClient?.pushMessages(id, messages);
+            }
+          }
+        }).catch((error) => {
+          console.error(`[DebugHub] Claw re-register \u5931\u8D25: ${error.message}`);
+        });
+      }
+      return;
+    }
+    if (this.agents.size === 0) {
+      return;
+    }
+    console.log(`[DebugHub] \u91CD\u65B0\u6CE8\u518C ${this.agents.size} \u4E2A Agent...`);
+    for (const [id, data] of this.agents) {
+      const hookInspector = data.agent.buildHookInspectorSnapshot?.() || data.agent.hookInspector;
+      const overview = data.agent.buildOverviewSnapshot?.();
+      const templatePayload = this.agentTemplatePayload.get(id) || { mounts: [], entries: {} };
+      const activeInputRequest = this.activeInputRequests.get(id);
+      if (activeInputRequest) {
+        console.log(`[DebugHub] \u53D1\u73B0\u6D3B\u8DC3\u8F93\u5165\u8BF7\u6C42: ${activeInputRequest.requestId}`);
+      }
+      this.sendToWorker({
+        type: "register-agent",
+        agentId: id,
+        name: data.info.name,
+        createdAt: data.info.registeredAt,
+        projectRoot: data.info.projectRoot || process.cwd(),
+        templateMounts: templatePayload.mounts,
+        templateEntries: templatePayload.entries,
+        hookInspector,
+        overview,
+        activeInputRequest,
+        // 携带活跃输入请求
+        inputPolicy: this.agentInputPolicy.get(id) || void 0
+      });
+      const tools = data.agent.tools;
+      if (tools && typeof tools.getEntries === "function") {
+        const entries = tools.getEntries();
+        const toolList = entries.map((e) => e.tool);
+        if (toolList.length > 0) {
+          this.sendToWorker({
+            type: "register-tools",
+            agentId: id,
+            tools: toolList
+          });
+        }
+      }
+      const context = data.agent.getContext?.();
+      if (context && typeof context.getAll === "function") {
+        const messages = context.getAll();
+        if (messages.length > 0) {
+          this.sendToWorker({
+            type: "push-messages",
+            agentId: id,
+            messages
+          });
+          console.log(`[DebugHub] \u6062\u590D Agent ${id} \u7684 ${messages.length} \u6761\u6D88\u606F`);
+        }
+      }
+    }
+    console.log(`[DebugHub] \u2705 \u91CD\u65B0\u6CE8\u518C\u5B8C\u6210`);
+  }
+  /**
+   * 安排重连（指数退避）
+   */
+  scheduleReconnect() {
+    if (this.stopped) {
+      return;
+    }
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+    }
+    if (this.reconnectAttempts >= this.MAX_RECONNECT_ATTEMPTS) {
+      console.error(`[DebugHub] \u8FBE\u5230\u6700\u5927\u91CD\u8FDE\u6B21\u6570 (${this.MAX_RECONNECT_ATTEMPTS})\uFF0C\u505C\u6B62\u91CD\u8FDE`);
+      return;
+    }
+    this.reconnectAttempts++;
+    const delay = Math.min(
+      this.RECONNECT_DELAY * Math.pow(2, this.reconnectAttempts - 1),
+      3e4
+    );
+    console.log(`[DebugHub] ${delay}ms \u540E\u5C1D\u8BD5\u7B2C ${this.reconnectAttempts} \u6B21\u91CD\u8FDE...`);
+    this.reconnectTimer = setTimeout(async () => {
+      try {
+        await this.connectToWorker();
+        console.log("[DebugHub] \u2705 \u91CD\u8FDE\u6210\u529F\uFF0C\u8C03\u8BD5\u529F\u80FD\u5DF2\u6062\u590D");
+      } catch (error) {
+        console.error(`[DebugHub] \u91CD\u8FDE\u5931\u8D25: ${error.message}`);
+        if (!this.stopped) {
+          this.scheduleReconnect();
+        }
+      }
+    }, delay);
+  }
+  /**
+   * 通过 UDS 发送消息
+   */
+  sendViaUDS(msg) {
+    if (this.udsClient && this.clientReady) {
+      this.udsClient.write(JSON.stringify(msg) + "\n");
+    }
+  }
+  /** Cancel every input request owned by one Agent. Safe to call repeatedly. */
+  cancelInputRequests(agentId, reason = `Agent '${agentId}' input was cancelled`) {
+    for (const [requestId, pending] of this.pendingInputRequests) {
+      if (pending.agentId !== agentId) continue;
+      pending.abortController?.abort();
+      this.settleInputRequest(requestId, { error: this.createAbortError(reason) });
+      this.sendToWorker({ type: "input-request-cancelled", agentId, requestId });
+    }
+    this.activeInputRequests.delete(agentId);
+  }
+  settleInputRequest(requestId, outcome) {
+    const pending = this.pendingInputRequests.get(requestId);
+    if (!pending) return;
+    this.pendingInputRequests.delete(requestId);
+    if (pending.timer) clearTimeout(pending.timer);
+    const active = this.activeInputRequests.get(pending.agentId);
+    if (active?.requestId === requestId) {
+      this.activeInputRequests.delete(pending.agentId);
+    }
+    if ("response" in outcome) {
+      pending.resolve(outcome.response);
+    } else {
+      pending.reject(outcome.error);
+    }
+  }
+  createAbortError(message) {
+    const error = new Error(message);
+    error.name = "AbortError";
+    return error;
+  }
+  /**
+   * 发送消息到 Worker
+   */
+  sendToWorker(msg) {
+    if (!this.udsClient || !this.clientReady) {
+      if (!this.sendToWorkerWarnedTypes.has(msg.type)) {
+        this.sendToWorkerWarnedTypes.add(msg.type);
+        console.warn(`[DebugHub] ViewerWorker transport is not ready; deferred state will reconcile on reconnect (message=${msg.type})`);
+      }
+      return;
+    }
+    this.sendViaUDS(msg);
+  }
+};
+
+// src/core/notification.ts
+var notificationAls = new AsyncLocalStorage();
+function runWithNotificationScope(agentId, fn) {
+  return notificationAls.run(
+    { agentId, lastNotificationTime: 0, lastLLMPhase: null },
+    fn
+  );
+}
+var _fallbackAgentId = null;
+var _fallbackLastTime = 0;
+var _fallbackLastPhase = null;
+var _fallbackScope = {
+  get agentId() {
+    return _fallbackAgentId;
+  },
+  get lastNotificationTime() {
+    return _fallbackLastTime;
+  },
+  set lastNotificationTime(v) {
+    _fallbackLastTime = v;
+  },
+  get lastLLMPhase() {
+    return _fallbackLastPhase;
+  },
+  set lastLLMPhase(v) {
+    _fallbackLastPhase = v;
+  }
+};
+function getActiveScope() {
+  const als = notificationAls.getStore();
+  if (als) return als;
+  if (_fallbackAgentId) return _fallbackScope;
+  return null;
+}
+var THROTTLE_INTERVAL = 100;
+function _setNotificationAgent(agentId) {
+  _fallbackAgentId = agentId;
+}
+function _clearNotificationAgent() {
+  _fallbackAgentId = null;
+  _fallbackLastTime = 0;
+  _fallbackLastPhase = null;
+}
+function _getCurrentNotificationAgent() {
+  return notificationAls.getStore()?.agentId ?? _fallbackAgentId;
+}
+function emitNotification(notification) {
+  const scope = getActiveScope();
+  if (!scope) {
+    return;
+  }
+  const now = Date.now();
+  const notificationType = String(notification.type || "");
+  const bypassThrottle = notificationType === "call.start" || notificationType === "call.finish" || notificationType === "llm.complete";
+  let phaseTransition = false;
+  if (notificationType === "llm.char_count") {
+    const data = notification.data;
+    const phase = typeof data?.phase === "string" ? data.phase : "";
+    if (phase && phase !== scope.lastLLMPhase) {
+      phaseTransition = true;
+      scope.lastLLMPhase = phase;
+    }
+  }
+  if (notification.category === "state" && !bypassThrottle && !phaseTransition) {
+    const timeSinceLast = now - scope.lastNotificationTime;
+    if (timeSinceLast < THROTTLE_INTERVAL) {
+      return;
+    }
+    scope.lastNotificationTime = now;
+  } else if (phaseTransition) {
+    scope.lastNotificationTime = now;
+  }
+  const debugHub = DebugHub.getInstance();
+  debugHub.pushNotification(scope.agentId, notification);
+}
+function createLLMCharCount(charCount, phase, extras) {
+  return {
+    type: "llm.char_count",
+    category: "state",
+    timestamp: Date.now(),
+    data: {
+      charCount,
+      phase,
+      ...typeof extras?.thinkingChars === "number" ? { thinkingChars: extras.thinkingChars } : {},
+      ...typeof extras?.contentChars === "number" ? { contentChars: extras.contentChars } : {},
+      ...typeof extras?.toolCallCount === "number" ? { toolCallCount: extras.toolCallCount } : {},
+      ...Array.isArray(extras?.streamToolNames) && extras.streamToolNames.length > 0 ? { streamToolNames: extras.streamToolNames } : {}
+    }
+  };
+}
+function createLLMComplete(totalChars) {
+  return {
+    type: "llm.complete",
+    category: "state",
+    timestamp: Date.now(),
+    data: {
+      totalChars
+    }
+  };
+}
+function createLLMRetry(data) {
+  return {
+    type: "llm.retry",
+    category: "event",
+    timestamp: Date.now(),
+    data: { ...data }
+  };
+}
+function createToolStart(toolName) {
+  return {
+    type: "tool.start",
+    category: "event",
+    timestamp: Date.now(),
+    data: {
+      toolName
+    }
+  };
+}
+function createToolComplete(toolName, success, duration) {
+  return {
+    type: "tool.complete",
+    category: "event",
+    timestamp: Date.now(),
+    data: {
+      toolName,
+      success,
+      duration
+    }
+  };
+}
+function createToolProgress(data) {
+  return {
+    type: "tool.progress",
+    category: "state",
+    timestamp: Date.now(),
+    data: { ...data }
+  };
+}
+function createCallStart() {
+  return {
+    type: "call.start",
+    category: "state",
+    timestamp: Date.now(),
+    data: {}
+  };
+}
+function createCallFinish(outcome) {
+  return {
+    type: "call.finish",
+    category: "state",
+    timestamp: Date.now(),
+    data: { ...outcome }
+  };
+}
+
+export {
+  getDefaultUDSPath,
+  resolveDebugTransportMode,
+  getClawRuntimeUrl,
+  getDebugCapabilities,
+  DebugHub,
+  runWithNotificationScope,
+  _setNotificationAgent,
+  _clearNotificationAgent,
+  _getCurrentNotificationAgent,
+  emitNotification,
+  createLLMCharCount,
+  createLLMComplete,
+  createLLMRetry,
+  createToolStart,
+  createToolComplete,
+  createToolProgress,
+  createCallStart,
+  createCallFinish
+};
+//# sourceMappingURL=chunk-574NG4UB.js.map