@dsh-workbench/core 0.2.13 → 0.2.15

package/dist/host/index.js

@@ -18,6 +18,7 @@ var OPENCLI_PIN = "1.8.8";
 var PANELS_SERVICE = "workbenchPanels";
 var UNITS_SERVICE = "workbenchUnits";
 var PANEL_STATE_SERVICE = "workbenchPanelState";
+var DIY_DEBUG_SERVICE = "workbenchDiyDebug";
 var OPENCLI_TIMEOUT_MS = 12e4;
 var WARM_TIMEOUT_MS = 2e4;
 var INSTALL_TIMEOUT_MS = 3e5;
@@ -434,6 +435,119 @@ function createPanelStateStore() {
 		}
 	};
 }
+function alive(state, now) {
+	if (state === null) return null;
+	return now - state.at <= 144e5 ? state : null;
+}
+function ownerOf(state, sessionId, now) {
+	const held = alive(state, now);
+	if (held === null) return "none";
+	return held.sessionId === sessionId ? held : "not-owner";
+}
+function createDebugStore() {
+	let held = null;
+	const live = (now) => alive(held, now);
+	return {
+		live,
+		begin(pact) {
+			const current = alive(held, pact.now);
+			if (current !== null) return {
+				ok: false,
+				code: current.sessionId === pact.sessionId ? "already-held" : "held-by-other"
+			};
+			const state = {
+				phase: "debugging",
+				sessionId: pact.sessionId,
+				workspace: pact.workspace,
+				board: pact.board,
+				unit: pact.unit,
+				name: pact.name,
+				startedAt: pact.now,
+				at: pact.now
+			};
+			held = state;
+			return {
+				ok: true,
+				state
+			};
+		},
+		stall(sessionId, now) {
+			const found = ownerOf(held, sessionId, now);
+			if (typeof found === "string") return {
+				ok: false,
+				code: found
+			};
+			if (found.phase === "paused") return {
+				ok: false,
+				code: "already-paused"
+			};
+			const state = {
+				...found,
+				phase: "paused",
+				at: now
+			};
+			held = state;
+			return {
+				ok: true,
+				state
+			};
+		},
+		pause(sessionId, now) {
+			const found = ownerOf(held, sessionId, now);
+			if (typeof found === "string") return {
+				ok: false,
+				code: found
+			};
+			if (found.phase === "paused") return {
+				ok: false,
+				code: "already-paused"
+			};
+			const state = {
+				...found,
+				phase: "paused",
+				at: now
+			};
+			held = state;
+			return {
+				ok: true,
+				state
+			};
+		},
+		resume(sessionId, now) {
+			const found = ownerOf(held, sessionId, now);
+			if (typeof found === "string") return {
+				ok: false,
+				code: found
+			};
+			if (found.phase === "debugging") return {
+				ok: false,
+				code: "already-debugging"
+			};
+			const state = {
+				...found,
+				phase: "debugging",
+				at: now
+			};
+			held = state;
+			return {
+				ok: true,
+				state
+			};
+		},
+		stop(sessionId, now) {
+			const found = ownerOf(held, sessionId, now);
+			if (typeof found === "string") return {
+				ok: false,
+				code: found
+			};
+			held = null;
+			return {
+				ok: true,
+				state: found
+			};
+		}
+	};
+}
 //#endregion
 //#region ../shared/dist/host/opencli-window.js
 var OPENCLI_WINDOW_ENV = "OPENCLI_WINDOW=background";
@@ -2138,6 +2252,10 @@ function sessionWorkspace(exec) {
 	const cwd = exec?.agent?.session?.header?.cwd;
 	return typeof cwd === "string" && cwd.trim() !== "" ? cwd.trim() : null;
 }
+function sessionIdOf(exec) {
+	const id = exec?.agent?.session?.id;
+	return typeof id === "string" && id.trim() !== "" ? id.trim() : null;
+}
 function textOutput(text) {
 	return [{
 		type: "text",
@@ -2871,6 +2989,10 @@ var DIY_NET_STOP_TOOL = "workbench_diy_net_stop";
 var DIY_LOGS_WATCH_TOOL = "workbench_diy_logs_watch";
 var DIY_LOGS_READ_TOOL = "workbench_diy_logs_read";
 var DIY_LOGS_STOP_TOOL = "workbench_diy_logs_stop";
+var DIY_DEBUG_START_TOOL = "workbench_diy_debug_start";
+var DIY_DEBUG_PAUSE_TOOL = "workbench_diy_debug_pause";
+var DIY_DEBUG_RESUME_TOOL = "workbench_diy_debug_resume";
+var DIY_DEBUG_STOP_TOOL = "workbench_diy_debug_stop";
 var READ_TOOLS = [
 	PANELS_LIST_TOOL,
 	MODULES_LIST_TOOL,
@@ -2911,7 +3033,11 @@ var WRITE_TOOLS = [
 	MODULES_UNINSTALL_PLUGIN_TOOL,
 	MODULES_UPDATE_WORKBENCH_TOOL,
 	DIY_INSTALL_TOOL,
-	DIY_SHOW_TOOL
+	DIY_SHOW_TOOL,
+	DIY_DEBUG_START_TOOL,
+	DIY_DEBUG_PAUSE_TOOL,
+	DIY_DEBUG_RESUME_TOOL,
+	DIY_DEBUG_STOP_TOOL
 ];
 var DIY_TOOLS = [
 	DIY_LIST_TOOL,
@@ -2938,6 +3064,12 @@ var DIY_TOOLS = [
 	DIY_LOGS_READ_TOOL,
 	DIY_LOGS_STOP_TOOL
 ];
+var DIY_DEBUG_TOOLS = [
+	DIY_DEBUG_START_TOOL,
+	DIY_DEBUG_PAUSE_TOOL,
+	DIY_DEBUG_RESUME_TOOL,
+	DIY_DEBUG_STOP_TOOL
+];
 var panelsUnit = {
 	id: "panels",
 	card: null,
@@ -3031,6 +3163,13 @@ function askOf(reason, question, fallback) {
 	};
 }
 var panelsApproval = (call) => {
+	if (call.name === "workbench_diy_debug_start" || call.name === "workbench_diy_debug_resume") {
+		const starting = call.name === DIY_DEBUG_START_TOOL;
+		const unit = argsOf$1(call)["unit"];
+		const target = typeof unit === "string" && unit !== "" ? ` [${unit}]` : "";
+		return askOf(`${call.name}${target} takes over the user's screen to debug a workbench module`, pair(starting ? "要在「工作台DIY」那块板上开始调试 —— 调试中请留在那一屏，允许吗？" : "要接着调试 —— 请回到「工作台DIY」那一屏，允许吗？", starting ? "it takes over your screen to debug on the workshop board — please stay on that screen. Allow?" : "it needs your screen again to keep debugging — please go back to the workshop board. Allow?"), pair(starting ? "agent 要占用你的屏幕开始调试工作台模块，允许吗？" : "agent 要接着占用你的屏幕调试，允许吗？", starting ? "The agent wants to take over your screen to start debugging a workbench module. Allow?" : "The agent wants your screen again to keep debugging. Allow?"));
+	}
+	if (call.name === "workbench_diy_debug_pause" || call.name === "workbench_diy_debug_stop") return { kind: "allow" };
 	if (call.name !== void 0 && DIY_TOOLS.includes(call.name)) return { kind: "allow" };
 	const raw = argsOf$1(call);
 	const text = (key) => {
@@ -3591,11 +3730,18 @@ function numberIn$1(value, fallback) {
 }
 var PAGE_PROBE = `(async () => {
   const answer = await fetch('/workbench/api/health').then((one) => one.json()).catch(() => null);
+  const bar = document.querySelector('.wb-rightbar');
+  const board = bar === null ? '' : (bar.getAttribute('data-wb-board') ?? '');
+  const open = bar === null ? null : bar.hasAttribute('data-wb-open');
+  const shown = bar === null ? false : getComputedStyle(bar).visibility !== 'hidden';
   return JSON.stringify({
     plugin: answer === null ? null : answer.plugin,
     pid: answer === null ? null : answer.pid,
     url: location.href,
     title: document.title,
+    board,
+    open,
+    shown,
   });
 })()`;
 function cardSelectorOf(unit) {
@@ -3657,6 +3803,7 @@ var NO_PICK = {
 var EMPTY_CARD = {
 	ok: false,
 	anchored: false,
+	visible: false,
 	width: 0,
 	height: 0,
 	head: "",
@@ -3703,10 +3850,13 @@ function measureScriptOf(unit, pick) {
   };
   const anchor = document.querySelector(${JSON.stringify(cardSelectorOf(unit))});
   const all = [...document.querySelectorAll('.wb-card')];
-  if (anchor === null) return JSON.stringify({ ok: false, cards: all.length, anchored: false });
+  if (anchor === null) return JSON.stringify({ ok: false, cards: all.length, anchored: false, visible: false });
   const card = anchor.classList.contains('wb-card') ? anchor : anchor.querySelector('.wb-card');
-  if (card === null) return JSON.stringify({ ok: false, cards: all.length, anchored: true });
+  if (card === null) return JSON.stringify({ ok: false, cards: all.length, anchored: true, visible: false });
   const box = card.getBoundingClientRect();
+  const painted = getComputedStyle(card);
+  const visible =
+    painted.visibility !== 'hidden' && painted.display !== 'none' && box.width > 0 && box.height > 0;
   const head = card.querySelector('.wb-cardTitle');
   const text = scrub(card.textContent);
   const shown = scrub(card.innerText);
@@ -3749,6 +3899,7 @@ function measureScriptOf(unit, pick) {
   return JSON.stringify({
     ok: true,
     cards: all.length,
+    visible,
     width: Math.ceil(box.width),
     height: Math.ceil(box.height),
     x: Math.round(box.x),
@@ -3900,12 +4051,19 @@ async function workbenchPageOf(shell, command, session) {
 	if (parsed === void 0) return {
 		ok: false,
 		url: "",
-		title: ""
+		title: "",
+		board: "",
+		open: null,
+		shown: false
 	};
+	const raw = parsed["open"];
 	return {
 		ok: textOf$4(parsed["plugin"]) === "@dsh-workbench/core",
 		url: textOf$4(parsed["url"]),
-		title: textOf$4(parsed["title"])
+		title: textOf$4(parsed["title"]),
+		board: textOf$4(parsed["board"]),
+		open: typeof raw === "boolean" ? raw : null,
+		shown: parsed["shown"] === true
 	};
 }
 async function writeShotsDir(shell, dir) {
@@ -3951,13 +4109,15 @@ async function measureCard(shell, command, session, unit, pick) {
 	if (parsed === void 0 || parsed["ok"] !== true) return {
 		...EMPTY_CARD,
 		cards: numberIn(parsed?.["cards"], 0),
-		anchored: parsed?.["anchored"] === true
+		anchored: parsed?.["anchored"] === true,
+		visible: parsed?.["visible"] === true
 	};
 	const width = numberIn(parsed["width"], 0);
 	const height = numberIn(parsed["height"], 0);
 	return {
 		ok: true,
 		anchored: true,
+		visible: parsed["visible"] === true,
 		width,
 		height,
 		head: textOf$4(parsed["head"]),
@@ -4036,6 +4196,25 @@ async function shootCard(shell, command, session, unit, file, view) {
 }
 //#endregion
 //#region src/modules/panels/model/diy-page.ts
+function debugPausedText(held) {
+	return `调试已暂停（${held.unit}）—— 动作族关闸，不再拿屏当目标。要接着看先 workbench_diy_debug_resume（会再要用户点头一次）；这之前可以改源码 / build / 跑门禁。`;
+}
+function debugForeignPactText(held) {
+	return `另一场调试正占着那块屏（${held.sessionId} 在调试 ${held.unit}）—— 一台机器同时只允许一场：让它先 workbench_diy_debug_stop，或等它收工。`;
+}
+function debugStalledText(held) {
+	return `你现在这一页画的不是工坊那块板 —— ${held.unit} 这场调试算**搁置**（已自动落 paused）：说好别离开那一屏。请用户在左栏切回「工作台DIY」；回到那一屏之后再 workbench_diy_debug_resume 接着看。`;
+}
+function boardStateOf(page, workshop) {
+	if (page.open === null) return "unknown";
+	if (!page.open || !page.shown) return "hidden";
+	if (page.board === "" || workshop === null) return "unknown";
+	return insideWorkshop(workshop, page.board) ? "workshop" : "other";
+}
+function boardGateText(board, unit, page, workshop) {
+	if (board === "hidden") return `右栏收着 —— 面板没画在屏上（锚点还在页面里，但看不见它）。让用户把面板展开、或切回「工作台DIY」，我再接着看 ${unit}。`;
+	return `你现在这一页画的是 ${page.board || "(不知道哪一块)"} 的面板，工坊那块板（${workshop ?? "(不知道)"}）没在这一屏 —— ${unit} 的这张卡不在屏上，我不拿别的板当目标。请用户在左栏切回「工作台DIY」；这之前我可以继续改源码 / build / 跑门禁。`;
+}
 async function pageAt(ctx, exec, raw, options = {}) {
 	const { packagesDir } = workshopOf(ctx, exec);
 	const args = asRecord$3(raw);
@@ -4053,6 +4232,20 @@ async function pageAt(ctx, exec, raw, options = {}) {
 		const { page } = handshake;
 		throw new Error(`你现在这一页不是工作台（${page.title || "(没有标题)"} ${page.url}）—— 把工作台那一页切到前台，再喊我一次。我只看用户正在看的那一页。`);
 	}
+	const workshop = workshopPathOf(ctx);
+	const board = boardStateOf(handshake.page, workshop);
+	const store = ctx.get(DIY_DEBUG_SERVICE);
+	const held = store?.live(Date.now()) ?? null;
+	const sessionId = sessionIdOf(exec);
+	if (options.requirePact !== false && held !== null) {
+		if (held.sessionId !== sessionId) throw new Error(debugForeignPactText(held));
+		if (held.phase === "paused") throw new Error(debugPausedText(held));
+		if (board === "other" || board === "hidden") {
+			store?.stall(sessionId ?? "", Date.now());
+			throw new Error(debugStalledText(held));
+		}
+	}
+	if (options.requireBoard !== false && (board === "other" || board === "hidden")) throw new Error(boardGateText(board, wanted, handshake.page, workshop));
 	return {
 		packagesDir,
 		unit: wanted,
@@ -4060,10 +4253,155 @@ async function pageAt(ctx, exec, raw, options = {}) {
 		shell,
 		command,
 		session,
-		bound: handshake.bound
+		bound: handshake.bound,
+		board,
+		boardPath: handshake.page.board
 	};
 }
 //#endregion
+//#region src/modules/panels/model/diy-debug-tools.ts
+var EMPTY = {
+	type: "object",
+	properties: {},
+	additionalProperties: false
+};
+function debugRefusalText(code, held) {
+	switch (code) {
+		case "held-by-other": return `另一场调试还占着那块屏（${held === void 0 ? "另一个会话" : held.sessionId}）—— 一台机器同时只允许一场：让它先 workbench_diy_debug_stop，或等它收工。`;
+		case "already-held": return `你这个会话已经持有一场调试（${held === void 0 ? "" : `${held.unit}，${held.phase}`}）—— 要换目标先 workbench_diy_debug_stop；暂停着要接着看用 workbench_diy_debug_resume。`;
+		case "not-owner": return "这个调试态不是你这个会话的 —— 谁开始的谁收工。";
+		case "none": return "现在没有调试态。";
+		case "already-paused": return "已经暂停了 —— 要接着看用 workbench_diy_debug_resume（会再要用户点头）。";
+		case "already-debugging": return "正在调试中，不用再开一次。";
+	}
+}
+function renderDebugStart(state) {
+	return [`开始调试 ${state.unit}（声明的目标：${state.board === "" ? "用户那一屏" : state.board}）。`, "现在看 / 动 / 网络那一族才把屏当目标 —— 收工前记得 workbench_diy_debug_stop。"].join("\n");
+}
+function renderDebugPause(state) {
+	return [`调试暂停了（${state.unit}）—— 动作族关闸，不再拿屏当目标。`, "改源码 / build / 跑门禁照常；要看屏再 workbench_diy_debug_resume（会再要用户点头一次）。"].join("\n");
+}
+function renderDebugResume(state) {
+	return [`继续调试 ${state.unit} —— 请用户回到「工作台DIY」那一屏。`, "卡不在屏上时我会当场拒（不拿别的板当目标）。"].join("\n");
+}
+function renderDebugStop(state) {
+	return `收工了：${state.unit} 的调试态清掉了（占用解除）。`;
+}
+function moveOrThrow(move, held) {
+	if (move.ok) return move.state;
+	throw new Error(debugRefusalText(move.code, held ?? void 0));
+}
+function registerDebugTools(ctx, tools, store) {
+	const startTool = {
+		name: DIY_DEBUG_START_TOOL,
+		description: "开始调试：占用用户那一屏（要点头一次）。声明 unit 之后，看 / 动那一族才把屏当目标。",
+		parameters: withApprovalNote({
+			type: "object",
+			properties: { unit: {
+				type: "string",
+				description: "工坊里的 unit（workbench_diy_list 会给）。"
+			} },
+			required: ["unit"],
+			additionalProperties: false
+		}, { required: true }),
+		output: OUTPUT$2,
+		async execute(raw, exec) {
+			const { packagesDir, workspace } = workshopOf(ctx, exec);
+			const unit = asText$1(asRecord$3(raw)["unit"]);
+			if (unit === "") {
+				const { modules } = modulesOf(ctx, packagesDir);
+				throw new Error(`要一个 unit（工坊里：${modules.map((one) => one.unit).join(", ") || "（空）"}）`);
+			}
+			const held = store.live(Date.now());
+			const page = await pageAt(ctx, exec, raw, {
+				requireBoard: false,
+				requirePact: false
+			});
+			const state = moveOrThrow(store.begin({
+				sessionId: sessionIdOf(exec) ?? "",
+				workspace: workspace ?? "",
+				board: page.boardPath,
+				unit,
+				name: modulesOf(ctx, packagesDir).modules.find((one) => one.unit === unit)?.name ?? unit,
+				now: Date.now()
+			}), held);
+			return plainJson({
+				workshop: packagesDir,
+				unit,
+				board: state.board,
+				phase: state.phase,
+				state,
+				text: renderDebugStart(state)
+			});
+		}
+	};
+	const pauseTool = {
+		name: DIY_DEBUG_PAUSE_TOOL,
+		description: "暂停调试（不审批）：动作族关闸，不再拿屏当目标。要看屏再 debug_resume。",
+		parameters: EMPTY,
+		output: OUTPUT$2,
+		async execute(_raw, exec) {
+			const { packagesDir } = workshopOf(ctx, exec);
+			const held = store.live(Date.now());
+			const state = moveOrThrow(store.pause(sessionIdOf(exec) ?? "", Date.now()), held);
+			return plainJson({
+				workshop: packagesDir,
+				unit: state.unit,
+				phase: state.phase,
+				state,
+				text: renderDebugPause(state)
+			});
+		}
+	};
+	const resumeTool = {
+		name: DIY_DEBUG_RESUME_TOOL,
+		description: "继续调试（要点头一次）：请用户回到「工作台DIY」那一屏。",
+		parameters: withApprovalNote(EMPTY, { required: true }),
+		output: OUTPUT$2,
+		async execute(_raw, exec) {
+			const { packagesDir } = workshopOf(ctx, exec);
+			const held = store.live(Date.now());
+			const page = await pageAt(ctx, exec, { unit: held?.unit ?? "" }, {
+				requireBoard: false,
+				requirePact: false,
+				requireUnit: false
+			});
+			const state = moveOrThrow(store.resume(sessionIdOf(exec) ?? "", Date.now()), held);
+			return plainJson({
+				workshop: packagesDir,
+				unit: state.unit,
+				board: page.boardPath,
+				phase: state.phase,
+				state,
+				text: renderDebugResume(state)
+			});
+		}
+	};
+	const stopTool = {
+		name: DIY_DEBUG_STOP_TOOL,
+		description: "结束调试（不审批）：清掉\"占用用户那一屏\"这件事。收工用它。",
+		parameters: EMPTY,
+		output: OUTPUT$2,
+		async execute(_raw, exec) {
+			const { packagesDir } = workshopOf(ctx, exec);
+			const held = store.live(Date.now());
+			const state = moveOrThrow(store.stop(sessionIdOf(exec) ?? "", Date.now()), held);
+			return plainJson({
+				workshop: packagesDir,
+				unit: state.unit,
+				phase: "idle",
+				text: renderDebugStop(state)
+			});
+		}
+	};
+	return [
+		tools.register(startTool),
+		tools.register(pauseTool),
+		tools.register(resumeTool),
+		tools.register(stopTool)
+	];
+}
+//#endregion
 //#region src/modules/panels/model/diy-browser-act.ts
 var ACT_TIMEOUT_MS = 15e3;
 function actTargetOf(raw) {
@@ -4321,16 +4659,20 @@ function registerLookTools(ctx, tools) {
 		},
 		output: OUTPUT$2,
 		async execute(raw, exec) {
-			const { packagesDir, unit, shell, command, session } = await pageAt(ctx, exec, raw);
+			const { packagesDir, unit, shell, command, session, board } = await pageAt(ctx, exec, raw);
 			const pick = pickOf(asRecord$3(raw));
 			let view = await measureCard(shell, command, session, unit, pick);
-			if (!view.ok) return plainJson({
-				workshop: packagesDir,
-				unit,
-				ok: false,
-				cards: view.cards,
-				text: renderMissingCard(unit, view.cards, view.anchored)
-			});
+			if (!view.ok || !view.visible) {
+				const state = view.ok ? "hidden" : board;
+				return plainJson({
+					workshop: packagesDir,
+					unit,
+					ok: false,
+					board: state,
+					cards: view.cards,
+					text: renderMissingCard(unit, view, state)
+				});
+			}
 			if (!insideViewportOf(view)) {
 				await scrollIntoView(shell, command, session, unit, "");
 				view = await measureCard(shell, command, session, unit, pick);
@@ -4431,9 +4773,12 @@ function renderLook(unit, view, shot, pick) {
 		...view.clipped ? ["有内容被裁掉了（某一格比它自己的宽度还宽）—— 这是要改的信号"] : []
 	].join("\n");
 }
-function renderMissingCard(unit, cards, anchored) {
-	if (anchored) return `面板里给 ${unit} 留了位置（锚点在），但里面没有卡片 —— 它的 View 没画出来：要么渲染时抛了（看 workbench_diy_panel 的运行态上报与 workbench_diy_status），要么它返回了空 / 没套卡壳。你现在这一页面板里一共 ${String(cards)} 张卡。`;
-	return `你现在这一页的面板里没有 ${unit} 这张卡（面板里现在有 ${String(cards)} 张卡）。三件事，按顺序试：① workbench_diy_show（unit=${unit}）把它上板；② 右栏可能没停在「工作台面板」那一列 —— 让用户切回来；③ 页面上跑的外壳可能还是旧的一份（锚点由外壳盖）—— 让用户刷新一次页面。`;
+function renderMissingCard(unit, view, board) {
+	if (board === "other") return `你现在这一页画的是别的工作区的面板，工坊那块板没在这一屏 —— ${unit} 的卡不在屏上，我不拿别的板当目标。请用户在左栏切回「工作台DIY」，或把这张卡上到他正看着的那块板上。`;
+	if (board === "hidden") return `右栏收着 —— 面板没画在屏上（锚点还在页面里，但看不见它），量不到也不该拍 ${unit}。让用户把面板展开、或切回「工作台DIY」，我再接着看。`;
+	if (view.anchored) return `面板里给 ${unit} 留了位置（锚点在），但里面没有卡片 —— 它的 View 没画出来：要么渲染时抛了（看 workbench_diy_panel 的运行态上报与 workbench_diy_status），要么它返回了空 / 没套卡壳。你现在这一页面板里一共 ${String(view.cards)} 张卡。`;
+	const stale = board === "unknown" ? "③ 页面上跑的外壳可能还是旧的一份（锚点由外壳盖）—— 让用户刷新一次页面。" : "";
+	return `你现在这一页的面板里没有 ${unit} 这张卡（面板里现在有 ${String(view.cards)} 张卡）。按顺序试：① workbench_diy_show（unit=${unit}）把它上板；② 右栏可能没停在「工作台面板」那一列 —— 让用户切回来。${stale}`;
 }
 //#endregion
 //#region src/modules/panels/model/diy-logs.ts
@@ -5483,7 +5828,7 @@ function renderList(packagesDir, modules) {
 }
 //#endregion
 //#region src/modules/panels/model/diy-tools.ts
-function registerDiyTools(ctx, market, panels) {
+function registerDiyTools(ctx, market, panels, debug) {
 	const tools = ctx.get("tools");
 	if (tools === void 0) {
 		ctx.logger?.info?.("[dsh-workbench] 没有 tools 服务，跳过 DIY 工坊工具注册");
@@ -5831,11 +6176,20 @@ function registerDiyTools(ctx, market, panels) {
 		...registerLogTools(ctx, tools),
 		...registerNetTools(ctx, tools),
 		...registerActTools(ctx, tools),
+		...registerDebugTools(ctx, tools, debug),
 		tools.register(showTool),
 		tools.register(installTool)
 	];
 }
 //#endregion
+//#region src/modules/panels/model/diy-debug-routes.ts
+function diyDebugRoutes(store) {
+	return { "panels/diy-debug": () => ({
+		ok: true,
+		state: store.live(Date.now())
+	}) };
+}
+//#endregion
 //#region src/shared/api/host/release.ts
 function parseLedgerVersion(stdout, name) {
 	const parsed = parseJsonLoose(stdout);
@@ -7869,7 +8223,14 @@ function applyPanelsPref(panels, payload) {
 //#endregion
 //#region src/modules/panels/model/handoff.ts
 var PANELS_FACT = "panels";
+var DIY_DEBUG_FACT = "diy-debug";
 var CAPABILITY_FACT = "capability";
+var DEBUG_TOOLS = [
+	DIY_DEBUG_START_TOOL,
+	DIY_DEBUG_PAUSE_TOOL,
+	DIY_DEBUG_RESUME_TOOL,
+	DIY_DEBUG_STOP_TOOL
+];
 var PROVISION_TOOLS = {
 	[MODULES_INSTALL_TOOL]: "install",
 	[MODULES_UPDATE_TOOL]: "update",
@@ -7905,6 +8266,7 @@ function panelsFactsOf(call, manifests) {
 	if (call.source === "workbench_modules_list") return [PANELS_FACT, CAPABILITY_FACT];
 	if (call.source === "workbench_modules_update_workbench") return [PANELS_FACT, CAPABILITY_FACT];
 	if (call.source === "workbench_diy_list") return [PANELS_FACT];
+	if (DEBUG_TOOLS.includes(call.source)) return [DIY_DEBUG_FACT];
 	const request = requestOf(call);
 	if (request === void 0) return void 0;
 	return [
@@ -8479,6 +8841,8 @@ var OWNED = [{
 			logger
 		});
 		ctx.provide(PANELS_SERVICE, panels);
+		const debug = createDebugStore();
+		ctx.provide(DIY_DEBUG_SERVICE, debug);
 		const profileDir = profileDirOf(ctx);
 		const shell = ctx.get("shell");
 		const moduleManifests = () => {
@@ -8526,12 +8890,13 @@ var OWNED = [{
 				...pluginRoutes({
 					ledger,
 					...shell === void 0 ? {} : { shell }
-				})
+				}),
+				...diyDebugRoutes(debug)
 			},
 			registerTools: () => [
 				...registerPanelTools(ctx, panels, values),
 				...registerMarketTools(ctx, market),
-				...registerDiyTools(ctx, market, panels)
+				...registerDiyTools(ctx, market, panels, debug)
 			],
 			factsOf: (call) => panelsFactsOf(call, manifests()),
 			needsApproval: panelsApproval,
@@ -8542,7 +8907,7 @@ var OWNED = [{
 					return [...manifests().flatMap((manifest) => owned.has(manifest.id) || resolveScope({
 						id: manifest.id,
 						boards
-					}) ? [] : manifest.tools.map((tool) => tool.name)), ...inWorkshopSession(ctx, workspace) ? [] : [...DIY_TOOLS]];
+					}) ? [] : manifest.tools.map((tool) => tool.name)), ...inWorkshopSession(ctx, workspace) ? [] : [...DIY_TOOLS, ...DIY_DEBUG_TOOLS]];
 				},
 				subscribe: (listener) => panels.subscribe(listener)
 			},