@agentdevjs/viewer 0.1.0

package/dist/cli/server.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli/server.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import {
+  ViewerWorker
+} from "../chunk-OPBQEOJC.js";
+
+// src/cli/server.ts
+import { getDefaultUDSPath } from "@agentdevjs/core";
+var DEFAULT_PORT = 2026;
+async function main() {
+  const port = parseInt(process.env.AGENTDEV_PORT || process.argv[2] || String(DEFAULT_PORT), 10);
+  const openBrowser = process.env.AGENTDEV_OPEN_BROWSER !== "false" && process.argv[3] !== "false";
+  const udsPath = process.env.AGENTDEV_UDS_PATH || process.argv[4];
+  console.log("=".repeat(50));
+  console.log("ViewerWorker \u670D\u52A1\u5668\u542F\u52A8\u4E2D...");
+  console.log(`  HTTP \u7AEF\u53E3: ${port}`);
+  console.log(`  UDS \u8DEF\u5F84: ${udsPath || getDefaultUDSPath()}`);
+  console.log(`  \u81EA\u52A8\u6253\u5F00\u6D4F\u89C8\u5668: ${openBrowser ? "\u662F" : "\u5426"}`);
+  console.log("=".repeat(50));
+  const worker = new ViewerWorker(port, openBrowser, udsPath);
+  try {
+    await worker.start();
+    console.log("\n\u2713 \u670D\u52A1\u5668\u5DF2\u542F\u52A8!");
+    console.log(`
+\u8C03\u8BD5\u9875\u9762: http://localhost:${port}`);
+    console.log("\n\u6309 Ctrl+C \u505C\u6B62\u670D\u52A1\u5668\n");
+  } catch (err) {
+    console.error("\n\u2717 \u670D\u52A1\u5668\u542F\u52A8\u5931\u8D25:", err);
+    process.exit(1);
+  }
+}
+process.on("SIGINT", () => {
+  console.log("\n\n[Server] \u6B63\u5728\u505C\u6B62\u670D\u52A1\u5668...");
+  process.exit(0);
+});
+process.on("SIGTERM", () => {
+  console.log("\n\n[Server] \u6B63\u5728\u505C\u6B62\u670D\u52A1\u5668...");
+  process.exit(0);
+});
+main().catch((err) => {
+  console.error("[Server] \u672A\u5904\u7406\u7684\u9519\u8BEF:", err);
+  process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/cli/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/server.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * ViewerWorker 服务器启动程序\n *\n * 用途：独立启动调试查看器服务器\n * 运行：npm run server [port] [no-browser] [uds-path]\n *\n * 功能：\n * - 启动 ViewerWorker 独立进程\n * - 服务器运行期间可以被多个 Agent 连接\n * - Ctrl+C 关闭服务器\n *\n * 参数：\n *   port - HTTP 端口（默认 2026）\n *   no-browser - 不自动打开浏览器（传递字符串 \"false\"）\n *   uds-path - 自定义 UDS 路径（可选）\n *\n * 环境变量：\n *   AGENTDEV_PORT - HTTP 端口（默认 2026）\n *   AGENTDEV_OPEN_BROWSER - 是否打开浏览器（默认 true）\n *   AGENTDEV_UDS_PATH - UDS 路径（默认自动检测平台）\n */\n\nimport { ViewerWorker } from '../viewer-worker.js';\nimport { getDefaultUDSPath } from '@agentdevjs/core';\n\nconst DEFAULT_PORT = 2026;\n\nasync function main() {\n  const port = parseInt(process.env.AGENTDEV_PORT || process.argv[2] || String(DEFAULT_PORT), 10);\n  const openBrowser = process.env.AGENTDEV_OPEN_BROWSER !== 'false' && process.argv[3] !== 'false';\n  const udsPath = process.env.AGENTDEV_UDS_PATH || process.argv[4];\n\n  console.log('='.repeat(50));\n  console.log('ViewerWorker 服务器启动中...');\n  console.log(`  HTTP 端口: ${port}`);\n  console.log(`  UDS 路径: ${udsPath || getDefaultUDSPath()}`);\n  console.log(`  自动打开浏览器: ${openBrowser ? '是' : '否'}`);\n  console.log('='.repeat(50));\n\n  const worker = new ViewerWorker(port, openBrowser, udsPath);\n\n  try {\n    await worker.start();\n\n    console.log('\\n✓ 服务器已启动!');\n    console.log(`\\n调试页面: http://localhost:${port}`);\n    console.log('\\n按 Ctrl+C 停止服务器\\n');\n\n    // 保持运行，直到用户中断\n  } catch (err) {\n    console.error('\\n✗ 服务器启动失败:', err);\n    process.exit(1);\n  }\n}\n\n// 优雅退出\nprocess.on('SIGINT', () => {\n  console.log('\\n\\n[Server] 正在停止服务器...');\n  process.exit(0);\n});\n\nprocess.on('SIGTERM', () => {\n  console.log('\\n\\n[Server] 正在停止服务器...');\n  process.exit(0);\n});\n\nmain().catch((err) => {\n  console.error('[Server] 未处理的错误:', err);\n  process.exit(1);\n});\n"],"mappings":";;;;;;AAwBA,SAAS,yBAAyB;AAElC,IAAM,eAAe;AAErB,eAAe,OAAO;AACpB,QAAM,OAAO,SAAS,QAAQ,IAAI,iBAAiB,QAAQ,KAAK,CAAC,KAAK,OAAO,YAAY,GAAG,EAAE;AAC9F,QAAM,cAAc,QAAQ,IAAI,0BAA0B,WAAW,QAAQ,KAAK,CAAC,MAAM;AACzF,QAAM,UAAU,QAAQ,IAAI,qBAAqB,QAAQ,KAAK,CAAC;AAE/D,UAAQ,IAAI,IAAI,OAAO,EAAE,CAAC;AAC1B,UAAQ,IAAI,sDAAwB;AACpC,UAAQ,IAAI,wBAAc,IAAI,EAAE;AAChC,UAAQ,IAAI,uBAAa,WAAW,kBAAkB,CAAC,EAAE;AACzD,UAAQ,IAAI,iDAAc,cAAc,WAAM,QAAG,EAAE;AACnD,UAAQ,IAAI,IAAI,OAAO,EAAE,CAAC;AAE1B,QAAM,SAAS,IAAI,aAAa,MAAM,aAAa,OAAO;AAE1D,MAAI;AACF,UAAM,OAAO,MAAM;AAEnB,YAAQ,IAAI,gDAAa;AACzB,YAAQ,IAAI;AAAA,6CAA4B,IAAI,EAAE;AAC9C,YAAQ,IAAI,kDAAoB;AAAA,EAGlC,SAAS,KAAK;AACZ,YAAQ,MAAM,wDAAgB,GAAG;AACjC,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;AAGA,QAAQ,GAAG,UAAU,MAAM;AACzB,UAAQ,IAAI,4DAAyB;AACrC,UAAQ,KAAK,CAAC;AAChB,CAAC;AAED,QAAQ,GAAG,WAAW,MAAM;AAC1B,UAAQ,IAAI,4DAAyB;AACrC,UAAQ,KAAK,CAAC;AAChB,CAAC;AAED,KAAK,EAAE,MAAM,CAAC,QAAQ;AACpB,UAAQ,MAAM,kDAAoB,GAAG;AACrC,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/dist/cli/viewer.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli/viewer.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import {
+  ViewerWorker
+} from "../chunk-OPBQEOJC.js";
+
+// src/cli/viewer.ts
+import { getDefaultUDSPath } from "@agentdevjs/core";
+var DEFAULT_PORT = 2026;
+async function main() {
+  const udsPath = process.env.AGENTDEV_UDS_PATH || process.argv[4] || getDefaultUDSPath();
+  const port = parseInt(process.env.AGENTDEV_PORT || process.argv[2] || String(DEFAULT_PORT), 10);
+  const openBrowser = process.env.AGENTDEV_OPEN_BROWSER !== "false" && process.argv[3] !== "false";
+  console.log(`[Viewer Worker] \u6B63\u5728\u542F\u52A8...`);
+  console.log(`[Viewer Worker] UDS: ${udsPath}`);
+  console.log(`[Viewer Worker] HTTP: http://localhost:${port}`);
+  const worker = new ViewerWorker(port, openBrowser, udsPath);
+  try {
+    await worker.start();
+    console.log("[Viewer Worker] \u542F\u52A8\u6210\u529F");
+  } catch (err) {
+    console.error("[Viewer Worker] \u542F\u52A8\u5931\u8D25:", err);
+    process.exit(1);
+  }
+  process.on("SIGINT", () => {
+    console.log("[Viewer Worker] \u6536\u5230\u9000\u51FA\u4FE1\u53F7\uFF0C\u6B63\u5728\u5173\u95ED...");
+    process.exit(0);
+  });
+  process.on("SIGTERM", () => {
+    console.log("[Viewer Worker] \u6536\u5230\u7EC8\u6B62\u4FE1\u53F7\uFF0C\u6B63\u5728\u5173\u95ED...");
+    process.exit(0);
+  });
+  process.on("uncaughtException", (err) => {
+    console.error("[Viewer Worker] \u672A\u6355\u83B7\u5F02\u5E38:", err);
+    process.exit(1);
+  });
+  process.on("unhandledRejection", (reason) => {
+    console.error("[Viewer Worker] \u672A\u5904\u7406\u7684 Promise \u62D2\u7EDD:", reason);
+    process.exit(1);
+  });
+}
+main();
+//# sourceMappingURL=viewer.js.map

package/dist/cli/viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/viewer.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Viewer Worker Standalone CLI\n *\n * 独立启动 ViewerWorker 服务器的命令行工具\n *\n * 使用方法：\n *   agentdev-viewer [port] [no-browser] [uds-path]\n *\n * 参数：\n *   port      - HTTP 端口（默认 2026）\n *   no-browser - 不自动打开浏览器（传递 \"false\"）\n *   uds-path  - 自定义 UDS 路径（可选）\n *\n * 环境变量：\n *   AGENTDEV_UDS_PATH - UDS 路径（默认自动检测平台）\n *   AGENTDEV_PORT - HTTP 端口（默认 2026）\n *   AGENTDEV_OPEN_BROWSER - 是否打开浏览器（默认 true）\n */\n\nimport { ViewerWorker } from '../viewer-worker.js';\nimport { getDefaultUDSPath } from '@agentdevjs/core';\n\nconst DEFAULT_PORT = 2026;\n\nasync function main() {\n  const udsPath = process.env.AGENTDEV_UDS_PATH || process.argv[4] || getDefaultUDSPath();\n  const port = parseInt(process.env.AGENTDEV_PORT || process.argv[2] || String(DEFAULT_PORT), 10);\n  const openBrowser = process.env.AGENTDEV_OPEN_BROWSER !== 'false' && process.argv[3] !== 'false';\n\n  console.log(`[Viewer Worker] 正在启动...`);\n  console.log(`[Viewer Worker] UDS: ${udsPath}`);\n  console.log(`[Viewer Worker] HTTP: http://localhost:${port}`);\n\n  const worker = new ViewerWorker(port, openBrowser, udsPath);\n\n  try {\n    await worker.start();\n    console.log('[Viewer Worker] 启动成功');\n  } catch (err) {\n    console.error('[Viewer Worker] 启动失败:', err);\n    process.exit(1);\n  }\n\n  // 防止进程退出（保持运行）\n  process.on('SIGINT', () => {\n    console.log('[Viewer Worker] 收到退出信号，正在关闭...');\n    process.exit(0);\n  });\n\n  process.on('SIGTERM', () => {\n    console.log('[Viewer Worker] 收到终止信号，正在关闭...');\n    process.exit(0);\n  });\n\n  // 添加未捕获异常处理\n  process.on('uncaughtException', (err) => {\n    console.error('[Viewer Worker] 未捕获异常:', err);\n    process.exit(1);\n  });\n\n  process.on('unhandledRejection', (reason) => {\n    console.error('[Viewer Worker] 未处理的 Promise 拒绝:', reason);\n    process.exit(1);\n  });\n}\n\nmain();\n"],"mappings":";;;;;;AAqBA,SAAS,yBAAyB;AAElC,IAAM,eAAe;AAErB,eAAe,OAAO;AACpB,QAAM,UAAU,QAAQ,IAAI,qBAAqB,QAAQ,KAAK,CAAC,KAAK,kBAAkB;AACtF,QAAM,OAAO,SAAS,QAAQ,IAAI,iBAAiB,QAAQ,KAAK,CAAC,KAAK,OAAO,YAAY,GAAG,EAAE;AAC9F,QAAM,cAAc,QAAQ,IAAI,0BAA0B,WAAW,QAAQ,KAAK,CAAC,MAAM;AAEzF,UAAQ,IAAI,6CAAyB;AACrC,UAAQ,IAAI,wBAAwB,OAAO,EAAE;AAC7C,UAAQ,IAAI,0CAA0C,IAAI,EAAE;AAE5D,QAAM,SAAS,IAAI,aAAa,MAAM,aAAa,OAAO;AAE1D,MAAI;AACF,UAAM,OAAO,MAAM;AACnB,YAAQ,IAAI,0CAAsB;AAAA,EACpC,SAAS,KAAK;AACZ,YAAQ,MAAM,6CAAyB,GAAG;AAC1C,YAAQ,KAAK,CAAC;AAAA,EAChB;AAGA,UAAQ,GAAG,UAAU,MAAM;AACzB,YAAQ,IAAI,uFAAgC;AAC5C,YAAQ,KAAK,CAAC;AAAA,EAChB,CAAC;AAED,UAAQ,GAAG,WAAW,MAAM;AAC1B,YAAQ,IAAI,uFAAgC;AAC5C,YAAQ,KAAK,CAAC;AAAA,EAChB,CAAC;AAGD,UAAQ,GAAG,qBAAqB,CAAC,QAAQ;AACvC,YAAQ,MAAM,mDAA0B,GAAG;AAC3C,YAAQ,KAAK,CAAC;AAAA,EAChB,CAAC;AAED,UAAQ,GAAG,sBAAsB,CAAC,WAAW;AAC3C,YAAQ,MAAM,kEAAoC,MAAM;AACxD,YAAQ,KAAK,CAAC;AAAA,EAChB,CAAC;AACH;AAEA,KAAK;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,330 @@
+import { IncomingMessage, ServerResponse } from 'http';
+import { UserTurnInput, UserTurnSubmissionResult, AgentSession, AgentOverviewSnapshot, TodoPlanSnapshot, InputRequestCancelledMsg, HookInspectorSnapshot, AgentLogsResponse, DebugLogEntry } from '@agentdevjs/core';
+
+/**
+ * Viewer Worker - 在独立进程中运行 HTTP 服务器
+ * 支持多 Agent 调试，共享单端口
+ * 支持通过 UDS（Unix Domain Socket）或 Windows Named Pipe 接收来自多进程的连接
+ */
+
+declare class ViewerWorker {
+    private port;
+    private openBrowser;
+    private server;
+    private udsPath;
+    private udsServer?;
+    private udsClients;
+    private agentSessions;
+    private templateMounts;
+    private templatePayloads;
+    private readonly debuggerMcp;
+    private readonly MAX_MESSAGES;
+    private readonly MAX_BYTES;
+    private readonly MAX_LOGS;
+    constructor(port: number, openBrowser?: boolean, udsPath?: string);
+    start(): Promise<void>;
+    /**
+     * 停止服务器
+     */
+    stop(): Promise<void>;
+    /**
+     * 启动 UDS 服务器
+     */
+    private startUDSServer;
+    /**
+     * 处理 UDS 消息（复用现有处理方法）
+     */
+    private handleUDSMessage;
+    private handleRequest;
+    /**
+     * 主页 - 带多 Agent 切换器
+     */
+    private handleIndex;
+    /**
+     * API 端点路由
+     */
+    private handleAPI;
+    /**
+     * GET /api/agents - 获取所有 Agent
+     */
+    private handleGetAgents;
+    /**
+     * GET /api/templates/feature - 获取 Feature 模板映射
+     */
+    handleGetFeatureTemplates(req: IncomingMessage, res: ServerResponse, searchParams?: URLSearchParams): void;
+    /**
+     * 解析 npm workspace 符号链接
+     * 当 Feature 来自 npm workspace 时，import.meta.url 返回的是符号链接的真实物理路径
+     * 需要检查 node_modules 目录中的符号链接来确定包名
+     */
+    private npmWorkspaceCache;
+    private resolveNpmWorkspacePackage;
+    /**
+     * GET /api/agents/:id/messages - 获取指定 Agent 的消息
+     */
+    private handleGetAgentMessages;
+    /**
+     * GET /api/agents/:id/tools - 获取指定 Agent 的工具
+     */
+    private handleGetAgentTools;
+    private handleGetAgentHooks;
+    private handleGetAgentOverview;
+    private handleGetAgentTodoPlan;
+    /**
+     * GET /api/agents/:id/notification - 获取指定 Agent 的通知状态
+     */
+    private handleGetAgentNotification;
+    private handleGetLogs;
+    private handleGetMCPInfo;
+    /**
+     * GET /api/agents/:id/connection - 获取指定 Agent 的真实连接状态
+     */
+    private handleGetAgentConnection;
+    /**
+     * DELETE /api/agents/:id - 删除已断开的 Agent 会话
+     */
+    private handleDeleteAgent;
+    /**
+     * 获取输入请求列表
+     */
+    private handleGetInputRequests;
+    /**
+     * 提交用户输入
+     */
+    private handlePostInput;
+    /**
+     * 提交一个不绑定 requestId 的新用户回合。
+     *
+     * inputLease 与 queuedInputs 都由 ViewerWorker 持有，因此仲裁必须
+     * 在这里原子完成，不能由宿主先 GET 再 POST 拼接，否则会产生 TOCTOU 竞态。
+     */
+    submitUserTurn(agentId: string, input: UserTurnInput): UserTurnSubmissionResult;
+    private handlePostUserTurn;
+    private forwardInputResponse;
+    private createTextInputResponse;
+    private enqueueQueuedInput;
+    /**
+     * 获取排队中的用户输入
+     */
+    private handleGetQueuedInputs;
+    /**
+     * 消费第一条排队消息
+     */
+    private handleDequeueInput;
+    /**
+     * 中断正在运行的 Agent
+     */
+    private handleInterrupt;
+    /**
+     * 查询 Agent 是否正在运行
+     */
+    private handleGetRunning;
+    /**
+     * 获取或创建会话
+     */
+    getOrCreateSession(agentId: string, name: string): AgentSession;
+    /**
+     * 更新会话活跃时间
+     */
+    updateSessionActivity(agentId: string): void;
+    private isSessionConnected;
+    /**
+     * 应用内存限制
+     */
+    enforceMemoryLimits(session: AgentSession): void;
+    /**
+     * 处理注册 Agent
+     */
+    handleRegisterAgent(msg: any, clientId?: string): void;
+    handleUpdateAgentInspector(msg: any): void;
+    handleUpdateAgentOverview(msg: {
+        agentId: string;
+        overview: AgentOverviewSnapshot;
+    }): void;
+    handleUpdateTodoPlan(msg: {
+        agentId: string;
+        plan: TodoPlanSnapshot;
+    }): void;
+    /**
+     * 清空 Feature 模板装载（当 Agent 断开连接时调用）：
+     * 移除该 agent 的载荷，并对 mount 注册表做引用计数回收。
+     */
+    private clearFeatureTemplates;
+    /**
+     * 处理推送消息（带去重优化）
+     *
+     * 只有在消息真正变化时才更新会话并触发前端更新
+     */
+    handlePushMessages(msg: any): void;
+    private createEmptyOverview;
+    private createEmptyTodoPlan;
+    private normalizeTodoPlan;
+    private createEmptyRuntimeState;
+    private cloneRuntimeState;
+    private getRuntimeStageFromLLMPhase;
+    private updateRuntimeStage;
+    private getSessionRuntimeState;
+    private getMergedOverview;
+    /**
+     * 检查消息是否发生变化
+     */
+    private hasMessagesChanged;
+    /**
+     * 获取最后一条消息的签名（用于变化检测）
+     *
+     * 使用消息的 role、content 和 toolCalls 生成签名
+     */
+    private getLastMessageSignature;
+    /**
+     * 处理注册工具
+     */
+    handleRegisterTools(msg: any): void;
+    /**
+     * 处理注销 Agent
+     */
+    handleUnregisterAgent(msg: any): void;
+    /**
+     * 处理停止
+     */
+    handleStop(): void;
+    /**
+     * 处理推送通知
+     */
+    handlePushNotification(msg: any): void;
+    private normalizeLogEntry;
+    private withSessionLogContext;
+    private parseNumberParam;
+    private listAgentSummaries;
+    private getAgentDetails;
+    private queryLogs;
+    private handleMCP;
+    /**
+     * 处理用户输入请求
+     */
+    handleRequestInput(msg: any): void;
+    /**
+     * 处理输入请求取消（运行时中断/销毁时由 DebugHub 发出）
+     * 只有 requestId 匹配当前租约时才清除，避免误删紧随其后重开的新租约。
+     */
+    handleInputRequestCancelled(msg: InputRequestCancelledMsg): void;
+    /**
+     * mountId：装载根目录的稳定哈希（sha1 前 12 hex）。与 agent 无关，
+     * 同一 root 跨 agent / 跨注册复用同一 ID，浏览器模块缓存天然共享。
+     */
+    private static mountIdForRoot;
+    /**
+     * /tpl/{mountId}/{rel...} — 模板装载资产服务。
+     * mount root 下的字节级镜像：模板文件、tsup 共享 chunk、sourcemap 同构命中。
+     * 唯一安全边界：resolve 后必须仍在 mount root 内（路径穿越防护）。
+     */
+    handleTplAsset(req: IncomingMessage, res: ServerResponse, url: string): void;
+    private getHtml;
+}
+
+interface DebuggerAgentSummary {
+    id: string;
+    name: string;
+    createdAt: number;
+    lastActive: number;
+    connected: boolean;
+    messageCount: number;
+    toolCount: number;
+    logCount: number;
+    hasHookInspector: boolean;
+}
+interface DebuggerAgentDetails extends DebuggerAgentSummary {
+    projectRoot?: string;
+    currentStateType?: string | null;
+    pendingInputCount: number;
+    hookInspector?: HookInspectorSnapshot;
+}
+interface DebuggerLogQuery {
+    scope?: 'current' | 'all';
+    agentId?: string | null;
+    level?: string;
+    namespace?: string;
+    feature?: string;
+    lifecycle?: string;
+    from?: number;
+    to?: number;
+    limit?: number;
+    offset?: number;
+    search?: string;
+}
+interface DebuggerMCPDataSource {
+    listAgents(): DebuggerAgentSummary[];
+    getAgent(agentId: string): DebuggerAgentDetails | undefined;
+    getHooks(agentId: string): HookInspectorSnapshot | undefined;
+    queryLogs(query: DebuggerLogQuery): AgentLogsResponse;
+}
+declare const DEBUGGER_MCP_TOOL_DEFINITIONS: readonly [{
+    readonly name: "list_agents";
+    readonly description: "List all debugger-visible agents and basic session status.";
+}, {
+    readonly name: "get_agent";
+    readonly description: "Get a single agent by id. Supports \"self\".";
+}, {
+    readonly name: "get_hooks";
+    readonly description: "Get the hook inspector snapshot for an agent.";
+}, {
+    readonly name: "query_logs";
+    readonly description: "Query structured logs. Prefer adding filters to narrow results; unfiltered queries are auto-truncated.";
+}];
+declare const DEBUGGER_MCP_RESOURCE_DEFINITIONS: readonly [{
+    readonly uri: "debug://agents";
+    readonly description: "All visible debugger agents.";
+}, {
+    readonly uri: "debug://agents/{agentId}";
+    readonly description: "Detailed agent session snapshot for a specific agent.";
+}, {
+    readonly uri: "debug://agents/{agentId}/hooks";
+    readonly description: "Hook inspector snapshot for a specific agent.";
+}];
+declare const DEBUGGER_MCP_PROMPT_DEFINITIONS: readonly [{
+    readonly name: "analyze_errors";
+    readonly description: "Summarize recent error logs for an agent and suggest likely causes.";
+}, {
+    readonly name: "review_hooks";
+    readonly description: "Review an agent hook snapshot and identify ordering or binding issues.";
+}, {
+    readonly name: "diagnose_agent";
+    readonly description: "Produce a high-level diagnosis from the current agent snapshot, hooks, and recent warnings/errors.";
+}];
+declare class DebuggerMCPServer {
+    private readonly dataSource;
+    constructor(dataSource: DebuggerMCPDataSource);
+    handleRequest(req: IncomingMessage, res: ServerResponse): Promise<void>;
+    private createServer;
+    private registerTools;
+    private registerResources;
+    private registerPrompts;
+    /**
+     * 解析 agent 引用。'self' 解析为 callerAgentId；'current' 伪 ID 已随服务端
+     * current 语义移除，显式报错引导调用方传显式 ID；缺省返回 null（由调用方决定
+     * 如何呈现"未指定"）。
+     */
+    private resolvePromptAgent;
+    private resolveAgentRef;
+    private stringVar;
+}
+declare function createDebuggerAgentSummary(session: AgentSession, connected: boolean): DebuggerAgentSummary;
+declare function createDebuggerAgentDetails(session: AgentSession, connected: boolean): DebuggerAgentDetails;
+declare function filterDebuggerLogs(logs: DebugLogEntry[], query: Omit<DebuggerLogQuery, 'scope'> & {
+    limit?: number;
+    offset?: number;
+}): DebugLogEntry[];
+
+/**
+ * Viewer HTML Template - 调试器前端 HTML 模板（拆分版）
+ *
+ * 原始的单文件 viewer-html.ts 已按职责拆分为同目录下的多个模块。
+ * 本文件负责将各模块按正确顺序拼接为完整的 HTML 字符串。
+ */
+/**
+ * 生成调试器前端页面的完整 HTML
+ * @param port - HTTP 服务器端口号（保留用于 API 兼容，当前未使用）
+ * @returns 完整的 HTML 字符串
+ */
+declare function generateViewerHtml(port: number): string;
+
+export { DEBUGGER_MCP_PROMPT_DEFINITIONS, DEBUGGER_MCP_RESOURCE_DEFINITIONS, DEBUGGER_MCP_TOOL_DEFINITIONS, type DebuggerAgentDetails, type DebuggerAgentSummary, type DebuggerLogQuery, DebuggerMCPServer, ViewerWorker, createDebuggerAgentDetails, createDebuggerAgentSummary, filterDebuggerLogs, generateViewerHtml };

package/dist/index.js

@@ -0,0 +1,23 @@
+import {
+  DEBUGGER_MCP_PROMPT_DEFINITIONS,
+  DEBUGGER_MCP_RESOURCE_DEFINITIONS,
+  DEBUGGER_MCP_TOOL_DEFINITIONS,
+  DebuggerMCPServer,
+  ViewerWorker,
+  createDebuggerAgentDetails,
+  createDebuggerAgentSummary,
+  filterDebuggerLogs,
+  generateViewerHtml
+} from "./chunk-OPBQEOJC.js";
+export {
+  DEBUGGER_MCP_PROMPT_DEFINITIONS,
+  DEBUGGER_MCP_RESOURCE_DEFINITIONS,
+  DEBUGGER_MCP_TOOL_DEFINITIONS,
+  DebuggerMCPServer,
+  ViewerWorker,
+  createDebuggerAgentDetails,
+  createDebuggerAgentSummary,
+  filterDebuggerLogs,
+  generateViewerHtml
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@agentdevjs/viewer",
+  "version": "0.1.0",
+  "description": "AgentDev debugger viewer: ViewerWorker HTTP/UDS host, web UI, read-only debugger MCP",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "agentdev-viewer": "dist/cli/viewer.js",
+    "agentdev-server": "dist/cli/server.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@agentdevjs/core": "^0.1.0",
+    "@modelcontextprotocol/node": "^2.0.0",
+    "@modelcontextprotocol/server": "^2.0.0",
+    "open": "^11.0.0",
+    "zod": "^4.1.5"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/client": "^2.0.0",
+    "@types/node": "^20.11.0",
+    "tsup": "^8.3.5",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^4.1.10"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "agentdev",
+    "debugger",
+    "viewer",
+    "mcp"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/your-org/agentdev.git"
+  },
+  "license": "MIT"
+}