tabby-agentdeck 0.2.1 → 0.3.0

package/dist/deck.service.d.ts

@@ -27,6 +27,8 @@ export declare class AgentDeckService {
     private observer;
     private editing;
     private renderQueued;
+    /** Shift 물리 키가 눌려 있나 — IME 조합을 거친 Enter 는 shiftKey 가 지워져 온다 */
+    private shiftDownAt;
     /** rAF 가 멈춘 상황(창 가려짐)을 대비한 렌더 폴백 타이머 */
     private renderTimer;
     /** 직전에 적용한 폭 — 같은 값이면 DOM 을 다시 건드리지 않는다 */
@@ -213,6 +215,56 @@ export declare class AgentDeckService {
      * 브라우저 기본 붙여넣기여야 하고, 우리가 가로채면 아예 못 붙여넣게 된다.
      */
     private claimCtrlVKey;
+    /**
+     * Home / End 를 Tabby 핫키 테이블에서 걷어내 xterm 순정 경로로 돌려준다.
+     *
+     * 증상: 한글 마지막 음절이 조합 중일 때 Home/End 를 누르면 그 음절이 **커서를 따라간다**
+     * (2026-09-08 사용자 보고). 방향키는 멀쩡하다 — 그 차이가 곧 원인이다.
+     *
+     * 방향키는 핫키가 아니라서 xterm 의 키 경로를 그대로 탄다. 거기서는 조합 중에 아무 키나
+     * 들어오면 `CompositionHelper.keydown` 이 `_finalizeComposition(false)` 로 조합을
+     * **동기 전송**하고(`tabby-terminal/dist/index.js:44098`, `:44120` triggerDataEvent) 그다음
+     * 방향키를 보낸다 — 글자 먼저, 이동 나중이라 순서가 맞는다.
+     *
+     * Home/End 는 그 경로를 못 탄다. Tabby 가 `hotkeys.home` / `hotkeys.end` 로 선점해서
+     * `tabby-local/dist/index.js:613` 이 `sendInput('')` 를 **즉시** 쏘기 때문이다.
+     * xterm 을 거치지 않으니 조합 확정은 `compositionend` 경로로 밀리는데, 그쪽
+     * `_finalizeComposition(true)` 는 `setTimeout(..., 0)` 로 **비동기 전송**이다
+     * (`tabby-terminal/dist/index.js:44110`). 결국 커서 이동이 먼저 나가고 음절이 한 틱 뒤에
+     * 도착한다 — 앱은 옮겨간 자리에 글자를 찍는다.
+     *
+     * 그래서 고치는 방법은 핸들러를 더 얹는 게 아니라 **핫키를 놓아주는 것**이다. 비워두면
+     * xterm 이 Home/End 를 방향키와 똑같이 처리한다(조합 확정 → 키 전송). 되돌리려면
+     * `agentDeck.releaseHomeEnd: false` 후 설정에서 다시 지정하면 된다.
+     */
+    private releaseHomeEndHotkey;
+    /**
+     * Shift+Enter / Ctrl+Enter 를 document **캡처 단계**에서 직접 줄바꿈으로 바꾼다.
+     *
+     * 핫키(`agentdeck-newline`)에만 맡겼더니 한글을 치다 누르면 절반쯤 줄바꿈이 아니라
+     * **전송**이 됐다 (2026-09-08 사용자 보고: "50% 정도는 그냥 enter 로 들어간다").
+     * 진단로그에 증거가 남아 있다 — 오발신 순간 `enter-label` 이 발화했는데
+     * (`.agentdeck-diag.log` 00:54:59 `enter-label text="지금도 그랬"`), 그 핸들러는
+     * 수식키가 하나라도 눌려 있으면 맨 앞에서 빠져나간다. 즉 그 Enter 는 **shiftKey 가
+     * 지워진 채** 도착했다. 한글 IME 가 조합을 확정하며 Enter 를 한 번 삼키고, 뒤이어
+     * 내보내는 이벤트에는 Shift 상태를 싣지 않는 것이다. Shift 가 없으니 `Shift-Enter`
+     * 핫키에 매칭될 리 없고, xterm 은 평범한 Enter 로 0x0D 를 PTY 에 흘린다 —
+     * 쓰다 만 문장이 그대로 전송된다.
+     *
+     * 그래서 이벤트가 알려주는 수식키를 믿지 않고 **Shift 눌림을 우리가 따로 센다**.
+     * Shift 자체의 keydown/keyup 은 조합과 무관하게 그대로 오므로 IME 를 타지 않는다.
+     * 세어 둔 값이 썩는 것(키업 유실)을 막으려고 창 포커스가 나가거나, Shift 없이 평범한
+     * 글자가 들어오거나, 오래 묵으면(STALE_MS) 스스로 잊는다.
+     *
+     * 조합 중(`isComposing`/keyCode 229)인 Enter 는 손대지 않는다. 그건 "이 음절을
+     * 확정해라" 는 신호고 여기서 막으면 마지막 글자가 확정되지 못한 채 줄만 넘어간다.
+     * 확정이 끝나면 Enter 가 한 번 더 오니 그때 잡으면 글자 순서도 어긋나지 않는다.
+     *
+     * 캡처에서 전파를 끊는 이유는 claimCtrlVKey 와 같다 — 뒤에 걸린 경로(xterm 커스텀 키
+     * 핸들러 → pushKeyEvent, core 의 document 리스너, xterm 이 Enter 를 0x0D 로 흘리는
+     * 기본 동작)를 통째로 죽여야 줄바꿈이 정확히 한 번이 된다.
+     */
+    private claimShiftEnterKey;
     /**
      * Enter 를 눌러 프롬프트를 보낼 때, 그 프롬프트 원문을 작업 라벨로 삼는다.
      *
@@ -433,6 +485,12 @@ export declare class AgentDeckService {
     private disableBackgroundThrottling;
     private tick;
     private render;
+    /**
+     * 헤더 오른쪽의 상태별 집계 — `⏸ 2  ● 3  ○ 1` 처럼 0 이 아닌 상태만 급한 순서로 놓는다.
+     * 총 개수만 보이던 자리다. 세션을 여럿 띄우면 "몇 개가 나를 기다리나" 가 먼저 보여야 한다.
+     * 동적 텍스트는 textContent 로만 넣는다 (innerHTML 금지).
+     */
+    private renderHeadCount;
     private renderTab;
     /** 더블클릭 -> 작업 이름 인라인 편집 */
     private startLabelEdit;

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 import { AgentDeckService } from './deck.service';
 import { AgentDeckProfileService } from './profile.service';
 import { WorkNotifyService } from './notify.service';
+import { AgentDeckAlertService } from './alert.service';
+import { AgentDeckRecoveryService } from './recovery.service';
 import './styles.scss';
 export * from './api';
 export default class AgentDeckModule {
-    constructor(deck: AgentDeckService, profiles: AgentDeckProfileService, notify: WorkNotifyService);
+    constructor(deck: AgentDeckService, profiles: AgentDeckProfileService, notify: WorkNotifyService, alert: AgentDeckAlertService, recovery: AgentDeckRecoveryService);
 }