shellbase 0.9.0 → 0.9.1

package/dist/agent.js

@@ -168,6 +168,13 @@ export async function runAgent(options) {
             console.error('전송 실패:', err.message);
         }
     };
+    // 이 세션이 보내는 것들을 한 줄로 세운다 — 앞의 것이 끝나야 다음 것이 나간다.
+    const enqueueSend = (session, task) => {
+        const next = session.sendChain.then(task, task);
+        // 하나가 실패해도 줄 전체가 멈추면 안 되므로, 줄에는 성공/실패를 흡수한 것만 남긴다
+        session.sendChain = next.then(() => undefined, () => undefined);
+        return next;
+    };
     const flush = async (session) => {
         session.pendingFlush = null;
         if (!session.outBuffer)
@@ -175,20 +182,70 @@ export async function runAgent(options) {
         const chunk = session.outBuffer;
         session.outBuffer = '';
         session.lastSentAt = Date.now();
+        await enqueueSend(session, async () => {
+            try {
+                await channel.send({
+                    kind: 'output',
+                    to: session.deviceId,
+                    data: encryptFrame(chunk, session.frameKey),
+                }, { includeSelf: false });
+            }
+            catch (err) {
+                // 실패한 출력을 그냥 버리면 폰 화면이 깨진 채로 남으니, 다음 전송 앞에 다시 붙여 순서대로 재시도한다
+                session.outBuffer = chunk + session.outBuffer;
+                session.sendPenaltyUntil = Date.now() + SEND_PENALTY_MS;
+                console.error('출력 전송 실패, 다시 시도해요:', err.message);
+                if (!session.closing)
+                    scheduleFlush(session);
+            }
+        });
+    };
+    // 폰이 "화면을 통째로 다시 달라"고 할 때 (처음 접속·재연결·크기 변경 뒤).
+    const sendRestore = async (session) => {
+        if (session.restoring) {
+            // 보내는 중에 또 요청이 왔다 — 지금 것이 끝난 뒤 한 번만 더 보낸다.
+            // 두 벌을 동시에 보내면 조각이 서로 끼어들어 폰 화면에 같은 내용이 두 번 그려진다.
+            session.restoreAgain = true;
+            return;
+        }
+        session.restoring = true;
         try {
-            await channel.send({
-                kind: 'output',
-                to: session.deviceId,
-                data: encryptFrame(chunk, session.frameKey),
-            }, { includeSelf: false });
+            do {
+                session.restoreAgain = false;
+                if (session.closing)
+                    return;
+                // 지금 화면 상태를 통째로 보낼 참이다. 아직 못 보낸 출력(outBuffer)은 이미 그 화면 안에
+                // 들어 있다 — pty.onData 가 outBuffer 와 screen 에 같이 넣기 때문. 그대로 두면 복원 직후
+                // 같은 내용이 한 번 더 나가서 화면에 두 번 찍힌다. 여기서 버린다.
+                // (아래 await 전까지는 끊기지 않고 실행되므로, 버리는 것과 찍어내는 것 사이에 새 출력이
+                //  끼어들 틈이 없다)
+                if (session.pendingFlush !== null) {
+                    clearTimeout(session.pendingFlush);
+                    session.pendingFlush = null;
+                }
+                session.outBuffer = '';
+                let snapshot;
+                try {
+                    snapshot = session.serializer.serialize({ scrollback: RESTORE_SCROLLBACK_LINES });
+                }
+                catch (err) {
+                    console.error('화면 복원 준비 실패:', err.message);
+                    return;
+                }
+                // 화면을 먼저 지우고(2J·3J) 복원 내용을 보내야, 폰에 남아있던 예전 화면과 섞이지 않는다
+                const payload = `\x1b[H\x1b[2J\x1b[3J${snapshot}`;
+                for (let i = 0; i < payload.length; i += RESTORE_CHUNK) {
+                    const part = payload.slice(i, i + RESTORE_CHUNK);
+                    await enqueueSend(session, () => send({
+                        kind: 'output',
+                        to: session.deviceId,
+                        data: encryptFrame(part, session.frameKey),
+                    }));
+                }
+            } while (session.restoreAgain);
         }
-        catch (err) {
-            // 실패한 출력을 그냥 버리면 폰 화면이 깨진 채로 남으니, 다음 전송 앞에 다시 붙여 순서대로 재시도한다
-            session.outBuffer = chunk + session.outBuffer;
-            session.sendPenaltyUntil = Date.now() + SEND_PENALTY_MS;
-            console.error('출력 전송 실패, 다시 시도해요:', err.message);
-            if (!session.closing)
-                scheduleFlush(session);
+        finally {
+            session.restoring = false;
         }
     };
     const scheduleFlush = (session) => {
@@ -307,6 +364,9 @@ export async function runAgent(options) {
             inputApproved: false,
             approvalInFlight: false,
             outBuffer: '',
+            sendChain: Promise.resolve(),
+            restoring: false,
+            restoreAgain: false,
             lastSentAt: 0,
             sendPenaltyUntil: 0,
             pendingFlush: null,
@@ -456,26 +516,8 @@ export async function runAgent(options) {
         if (!session || session.closing)
             return;
         if (frame.kind === 'connect_request') {
-            // 화면 보기는 승인 여부와 무관하게 항상 되므로, 승인을 묻기 전에 지금 화면부터 그대로 복원해준다.
-            // 화면을 먼저 지우고(2J·3J) 복원 내용을 보내야, 폰에 남아있던 예전 화면과 섞이지 않는다.
-            void (async () => {
-                let snapshot;
-                try {
-                    snapshot = session.serializer.serialize({ scrollback: RESTORE_SCROLLBACK_LINES });
-                }
-                catch (err) {
-                    console.error('화면 복원 준비 실패:', err.message);
-                    return;
-                }
-                const payload = `\x1b[H\x1b[2J\x1b[3J${snapshot}`;
-                for (let i = 0; i < payload.length; i += RESTORE_CHUNK) {
-                    await send({
-                        kind: 'output',
-                        to: session.deviceId,
-                        data: encryptFrame(payload.slice(i, i + RESTORE_CHUNK), session.frameKey),
-                    });
-                }
-            })();
+            // 화면 보기는 승인 여부와 무관하게 항상 되므로, 승인을 묻기 전에 지금 화면부터 그대로 복원해준다
+            void sendRestore(session);
             // 승인을 묻지 않는 기본 설정에서는 요청이 올 때마다 곧바로 답한다.
             // (예전엔 "승인 진행 중"이면 건너뛰었는데, 그 사이 온 요청은 영영 답을 못 받아서
             //  폰이 "승인 대기 중" 화면에 갇히는 일이 생겼음 — 자동 승인은 기다릴 게 없으므로 항상 응답)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shellbase",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "내 컴퓨터 터미널(특히 Claude Code 세션)을 폰 브라우저로 실시간 접속하게 해주는 데스크톱 에이전트",
   "type": "module",
   "bin": {