@ait-co/devtools 0.1.141 → 0.1.142

package/dist/{attach-orchestrator-BEiz3wAx.js → attach-orchestrator-DL3NQ9ca.js}

@@ -1607,7 +1607,7 @@ async function renderAndMaybeWait(deps, prep, waitForAttach, callTimeoutMs, conn
 	let totpIssuedAt = nowMs();
 	let reminted = 0;
 	const relayUrl = parts.wssUrl;
-	const header = "This tool result is shown to the user directly — do NOT re-print the QR below in your reply (it wastes output tokens). Just tell the user to scan the QR in this output (Ctrl+O to expand if collapsed).";
+	const header = "This tool result is shown to the user directly — do NOT re-print the QR below in your reply (it wastes output tokens). Just tell the user to scan the QR in this output (Ctrl+O to expand if collapsed).\n\n테스트가 끝날 때까지 앱을 화면 앞에 유지하세요 — 백그라운드로 전환하면 디버그 세션이 끊어집니다.";
 	const warningPrefix = authorityWarning ? `⚠️  scheme_url 경고: ${authorityWarning}\n\n` : "";
 	const guiAvailable = canOpenBrowserFn();
 	/** Builds the totp object surfaced in results (fresh expiresAt + reminted). */
@@ -1733,9 +1733,35 @@ async function renderAndMaybeWait(deps, prep, waitForAttach, callTimeoutMs, conn
 	}, null, 2)}\n\n${qr}`);
 }
 /**
+* How long the disconnected badge stays on screen before it fades and removes
+* itself (#748). Long enough to read, short enough not to linger; a reconnect
+* within this window cancels the self-dismiss (transient tunnel blips do not
+* flash-remove the badge).
+*/
+const INDICATOR_SELF_DISMISS_MS = 5e3;
+/** Fade duration before the self-dismissed badge is detached from the DOM. */
+const INDICATOR_FADE_MS = 400;
+/**
+* Heartbeat / pending-call render tick (#749). 1 Hz — cheap enough to be
+* invisible (a single text write per second, no layout thrash) while making a
+* JS main-thread wedge obvious: the compositor-driven pulse dot keeps animating
+* but this JS-driven `♥<beats>` token freezes. Pending-call elapsed times are
+* recomputed on the same tick so they advance without any bridge event.
+*/
+const INDICATOR_HEARTBEAT_MS = 1e3;
+/**
+* Display-side staleness guard (#749): the badge skips rendering a pending call
+* older than this. A safety net independent of the in-app observer's own prune
+* (`bridge-observer.ts` MAX_PENDING_AGE_MS) — kept local so the daemon-graph
+* expression builder never imports the in-app module (install-graph invariant).
+* Generous enough that a genuinely slow native call still shows while plausibly
+* in flight.
+*/
+const INDICATOR_PENDING_STALE_MS = 12e4;
+/**
 * Builds a self-contained IIFE DOM expression that renders a LIVE
-* "Debugger Connected" / "Debugger Disconnected" badge on the bottom-left of
-* the phone screen (#730).
+* "Debugger Connected" / disconnected badge on the bottom-left of the phone
+* screen (#730), with a graceful self-dismiss on disconnect (#748).
 *
 * **Pure function** — returns a JS expression string; does NOT inject it.
 * Injection is performed by {@link injectDebugIndicator} in `cell.ts`.
@@ -1752,7 +1778,18 @@ async function renderAndMaybeWait(deps, prep, waitForAttach, callTimeoutMs, conn
 *   3. A `pointerdown` listener dismisses (hides) the badge on tap — dismiss
 *      is NON-terminal: a later state transition un-dismisses it, so a
 *      genuine disconnect after a dismissed tap is still visible.
-*   4. Observes relay-socket lifecycle WITHOUT opening any new connection:
+*   4. **Graceful self-dismiss (#748)** — the disconnected badge is NON-BLOCKING
+*      (`pointer-events:none` the moment it flips to disconnected, so it can
+*      never absorb a tap) and SELF-DISMISSING (it fades and detaches itself
+*      after {@link INDICATOR_SELF_DISMISS_MS}). This is why a run that ends
+*      with `close()` injecting `{ state: 'disconnected' }` no longer leaves a
+*      permanent grey "Debugger Disconnected" element on the phone. A reconnect
+*      (`setState(c, 'attached')`) cancels the pending self-dismiss and
+*      re-mounts the badge if it had already detached — transient tunnel blips
+*      do not flash-remove it, and a genuine re-attach restores it. The
+*      controller object is retained across dismiss (never `delete`d), so a
+*      later re-injection reuses it and never double-wraps `window.WebSocket`.
+*   5. Observes relay-socket lifecycle WITHOUT opening any new connection:
 *      - Preferred path: if the in-app module (`src/in-app/attach.ts`) has
 *        already installed its relay-WS observer (`window.__ait_relay_ws_observed`),
 *        subscribe to the `ait:relay-ws-state` CustomEvent it broadcasts.
@@ -1760,25 +1797,50 @@ async function renderAndMaybeWait(deps, prep, waitForAttach, callTimeoutMs, conn
 *        by PATHNAME SHAPE only (`/target/`) — never by host/wss value — so a
 *        bare CDP-injected badge (no in-app bundle) still reacts to the
 *        chii target socket's own open/close lifecycle.
+*   6. **Freeze/spinner triage (#749)** — renders three debug-only signals so a
+*      real-device spinner is attributable at a glance (run7):
+*      - **Main-thread heartbeat**: a compositor-driven pulse dot
+*        (`Element.animate`, keeps running during JS jank) PLUS a JS-driven
+*        `♥<beats>` token incremented by a 1 Hz `setInterval`. `CSS pulse alive
+*        + ♥ frozen = JS main-thread wedge`.
+*      - **Pending bridge calls**: in-flight native calls (API name + live
+*        elapsed) read from `window.__ait_bridge` (published by the in-app
+*        bridge observer, `src/in-app/bridge-observer.ts`). `⏳ present =
+*        native/Toss-app spinner`.
+*      - **Last SDK call stamp**: the most recent call's API name + wall-clock.
+*        `no ⏳ + heartbeat healthy = the miniapp's own UI`.
+*      The `title` tooltip states this mapping. When no in-app observer is
+*      present (env 2 mock / no bridge) the pending/last lines are simply empty
+*      — the heartbeat still renders. The 1 Hz interval is stored on the
+*      controller (`c.hb`) and stopped by `c.stop()` (called from
+*      `detachDebugSurface`) and by the self-dismiss removal, so no timer leaks
+*      past detach (#748 lifecycle).
 *
 * The expression intentionally contains NO relay URLs, wss addresses, TOTP
-* codes, or any other secrets. It is pure DOM UI text + enum state only.
+* codes, or any other secrets. `window.__ait_bridge` holds API NAMES + timings
+* only (never call arguments/results — see `bridge-observer.ts`
+* SECRET-HANDLING). It is pure DOM UI text + enum/name state only.
 *
 * SECRET-HANDLING: this expression contains no secrets, relay URLs, wss
 * addresses, or TOTP codes whatsoever — DOM label text + a structural
 * pathname match (`/target/`) only.
 *
 * @param opts.label - Attached-state badge text (default: `'Debugger Connected'`).
-* @param opts.disconnectedLabel - Disconnected-state badge text (default: `'Debugger Disconnected'`).
+* @param opts.disconnectedLabel - Disconnected-state badge text. Default is the
+*   Korean notice `'디버거 연결 끊김'` (ko-primary in-app string convention) —
+*   shown briefly then self-dismissed.
 * @param opts.state - Initial/forced state for THIS injection call (default: `'attached'`).
 * @returns A JS expression string suitable for `Runtime.evaluate`.
 */
 function buildIndicatorExpression(opts) {
 	const label = opts?.label ?? "Debugger Connected";
-	const disconnectedLabel = opts?.disconnectedLabel ?? "Debugger Disconnected";
-	return `(() => {var W = window;function render(c) {if (c.dismissed) { c.el.style.display = 'none'; return; }c.el.style.display = 'block';var up = c.state !== 'disconnected';c.el.style.background = up ? '#e5484d' : '#8a8f98';c.el.textContent = up ? ${JSON.stringify(label)} : ${JSON.stringify(disconnectedLabel)};}function setState(c, next) { c.state = next; c.dismissed = false; render(c); }var c = W.__ait_indicator;if (!c) {var el = document.createElement('div');el.id = '__ait_debug_indicator';el.style.cssText = ['position:fixed','left:max(12px,calc(env(safe-area-inset-left,0px) + 8px))','bottom:max(12px,calc(env(safe-area-inset-bottom,0px) + 8px))','z-index:2147483647','color:#fff','font:bold 11px/1 system-ui,sans-serif','padding:5px 9px','border-radius:6px','pointer-events:auto','user-select:none',].join(';');document.body.appendChild(el);c = { el: el, state: 'attached', dismissed: false };el.addEventListener('pointerdown', function () { c.dismissed = true; render(c); }, { passive: true });W.__ait_indicator = c;if (W.__ait_relay_ws_observed) {W.addEventListener('ait:relay-ws-state', function (e) {setState(c, e.detail && e.detail.state === 'open' ? 'attached' : 'disconnected');});} else {try {var Native = W.WebSocket;W.WebSocket = new Proxy(Native, {construct: function (t, a) {var ws = Reflect.construct(t, a);try {var u = new URL(String(a[0]), location.href);if (/\\/target\\//.test(u.pathname)) {ws.addEventListener('open', function () { setState(c, 'attached'); });ws.addEventListener('close', function () { setState(c, 'disconnected'); });ws.addEventListener('error', function () { setState(c, 'disconnected'); });}} catch (_) {}return ws;},});} catch (_) {}}}setState(c, ${JSON.stringify(opts?.state ?? "attached")});})()`;
+	const disconnectedLabel = opts?.disconnectedLabel ?? "디버거 연결 끊김";
+	const safeLabel = JSON.stringify(label);
+	const safeDisconnectedLabel = JSON.stringify(disconnectedLabel);
+	const safeState = JSON.stringify(opts?.state ?? "attached");
+	return `(() => {var W = window;function pad2(n) { return (n < 10 ? '0' : '') + n; }function clock(ms) { var d = new Date(ms); return pad2(d.getHours()) + ':' + pad2(d.getMinutes()) + ':' + pad2(d.getSeconds()); }function renderDetail(c) {c.beatEl.textContent = ' \\u2665' + c.beats;var b = W.__ait_bridge;var now = Date.now();var lines = [];if (b) {if (b.last) { lines.push('last: ' + b.last.method + ' ' + clock(b.last.at)); }var p = b.pending || {};var ids = Object.keys(p);var shown = 0;for (var i = 0; i < ids.length; i++) {var e = p[ids[i]];if (!e || now - e.startedAt > ${INDICATOR_PENDING_STALE_MS}) { continue; }if (shown < 3) { lines.push('\\u23f3 ' + e.method + ' ' + Math.max(0, Math.round((now - e.startedAt) / 1000)) + 's'); }shown++;}if (shown > 3) { lines.push('+' + (shown - 3) + ' more'); }}c.detailEl.textContent = lines.join('\\n');}function mount(c) { if (!c.el.isConnected && document.body) { document.body.appendChild(c.el); } }function render(c) {if (c.removed) { c.el.style.display = 'none'; return; }mount(c);if (c.dismissed) { c.el.style.display = 'none'; return; }c.el.style.display = 'block';c.el.style.opacity = '1';var up = c.state !== 'disconnected';c.el.style.background = up ? '#e5484d' : '#8a8f98';c.el.style.pointerEvents = up ? 'auto' : 'none';c.labelEl.textContent = up ? ${safeLabel} : ${safeDisconnectedLabel};c.dotEl.style.display = up ? 'inline-block' : 'none';c.beatEl.style.display = up ? 'inline' : 'none';c.detailEl.style.display = up ? 'block' : 'none';if (up) { renderDetail(c); } else { c.beatEl.textContent = ''; c.detailEl.textContent = ''; }}function clearTimers(c) { if (c.t1) { clearTimeout(c.t1); c.t1 = 0; } if (c.t2) { clearTimeout(c.t2); c.t2 = 0; } }function setState(c, next) {clearTimers(c);c.state = next; c.dismissed = false; c.removed = false;render(c);if (next === 'disconnected') {c.t1 = setTimeout(function () {try { c.el.style.transition = 'opacity ${INDICATOR_FADE_MS}ms ease'; c.el.style.opacity = '0'; } catch (_) {}c.t2 = setTimeout(function () { c.removed = true; if (c.hb) { clearInterval(c.hb); c.hb = 0; } if (c.el.parentNode) { c.el.parentNode.removeChild(c.el); } }, ${INDICATOR_FADE_MS});}, ${INDICATOR_SELF_DISMISS_MS});}}var c = W.__ait_indicator;if (!c) {var el = document.createElement('div');el.id = '__ait_debug_indicator';try { el.title = ${JSON.stringify("⏳ 네이티브 호출 대기 = 토스앱 스피너 · ♥ 정지 = JS 멈춤 · ⏳ 없고 ♥ 정상 = 앱 UI")}; } catch (_) {}el.style.cssText = ['position:fixed','left:max(12px,calc(env(safe-area-inset-left,0px) + 8px))','bottom:max(12px,calc(env(safe-area-inset-bottom,0px) + 8px))','z-index:2147483647','color:#fff','font:bold 11px/1.2 system-ui,sans-serif','padding:5px 9px','border-radius:6px','max-width:72vw','pointer-events:auto','user-select:none',].join(';');var dotEl = document.createElement('span');dotEl.style.cssText = 'display:inline-block;width:6px;height:6px;border-radius:50%;background:#fff;margin-right:5px;vertical-align:middle';var labelEl = document.createElement('span');labelEl.id = '__ait_indicator_label';var beatEl = document.createElement('span');beatEl.style.cssText = 'font-weight:normal;opacity:0.85;margin-left:6px';var detailEl = document.createElement('div');detailEl.style.cssText = 'font-weight:normal;font-size:10px;line-height:1.35;margin-top:3px;white-space:pre-line;opacity:0.95';el.appendChild(dotEl); el.appendChild(labelEl); el.appendChild(beatEl); el.appendChild(detailEl);document.body.appendChild(el);c = { el: el, dotEl: dotEl, labelEl: labelEl, beatEl: beatEl, detailEl: detailEl, state: 'attached', dismissed: false, removed: false, beats: 0, t1: 0, t2: 0, hb: 0 };try { dotEl.animate([{ opacity: 1 }, { opacity: 0.25 }, { opacity: 1 }], { duration: 1400, iterations: Infinity }); } catch (_) {}c.hb = (typeof setInterval !== 'undefined') ? setInterval(function () {if (c.removed || !c.el.isConnected) { if (c.hb) { clearInterval(c.hb); c.hb = 0; } return; }c.beats = (c.beats || 0) + 1;if (c.state !== 'disconnected' && !c.dismissed) { renderDetail(c); }}, ${INDICATOR_HEARTBEAT_MS}) : 0;c.stop = function () { clearTimers(c); if (c.hb) { clearInterval(c.hb); c.hb = 0; } };el.addEventListener('pointerdown', function () { c.dismissed = true; render(c); }, { passive: true });W.addEventListener('ait:bridge-call', function () { if (c.state !== 'disconnected' && !c.dismissed && !c.removed) { renderDetail(c); } });W.__ait_indicator = c;if (W.__ait_relay_ws_observed) {W.addEventListener('ait:relay-ws-state', function (e) {setState(c, e.detail && e.detail.state === 'open' ? 'attached' : 'disconnected');});} else {try {var Native = W.WebSocket;W.WebSocket = new Proxy(Native, {construct: function (t, a) {var ws = Reflect.construct(t, a);try {var u = new URL(String(a[0]), location.href);if (/\\/target\\//.test(u.pathname)) {ws.addEventListener('open', function () { setState(c, 'attached'); });ws.addEventListener('close', function () { setState(c, 'disconnected'); });ws.addEventListener('error', function () { setState(c, 'disconnected'); });}} catch (_) {}return ws;},});} catch (_) {}}}setState(c, ${safeState});})()`;
 }
 //#endregion
 export { buildIndicatorExpression as a, generateAttachToken as c, startQuickTunnel as d, startTunnelHealthProbe as f, attach_orchestrator_exports as i, makeTunnelStatus as l, logInfo as m, START_ATTACH_REMINT_THRESHOLD_MS as n, extractDeploymentId as o, logError as p, START_ATTACH_SEGMENT_MS as r, isSandboxPageFresh as s, RELAY_SANDBOX_STALE_PAGE_MS as t, printAttachBanner as u };
 
-//# sourceMappingURL=attach-orchestrator-BEiz3wAx.js.map
+//# sourceMappingURL=attach-orchestrator-DL3NQ9ca.js.map