shellbase 0.12.1 → 0.13.1

package/dist/agent.js

@@ -15,7 +15,7 @@ import { encryptFrame, decryptFrame, generateFrameKey } from './crypto.js';
 import { registerDevice, heartbeatDevice, unregisterDevice, listOnlineNames, renameDevice, markSessionDone, keepDevice, } from './devices.js';
 import { promptApproval } from './prompt.js';
 import { touchRecentDir } from './recent-dirs.js';
-import { listDirs, deleteEntry, renameEntry } from './browse.js';
+import { listDirs, createEntry, deleteEntry, renameEntry } from './browse.js';
 import { readTextFile, writeTextFile, chunkContent } from './files.js';
 import { AUDIO_CHUNK_TTL_MS, MAX_AUDIO_BASE64, STT_SETUP_HINT, findSttServer, transcribe, } from './stt.js';
 import { loadOpenSessions, saveOpenSessions } from './open-sessions.js';
@@ -34,8 +34,14 @@ const IMAGE_SWEEP_MS = 6 * 60 * 60 * 1000;
 const APPROVAL_TIMEOUT_MS = 30_000;
 // 복원해서 보낼 때 함께 보낼 이전 줄 수 (화면 위로 올려볼 수 있는 분량)
 const RESTORE_SCROLLBACK_LINES = 300;
-// 프레임 하나에 들어갈 수 있는 크기가 제한돼 있어서(실측 16KB 성공/64KB 실패) 나눠 보낸다
+// 프레임 하나에 들어갈 수 있는 크기가 제한돼 있어서(카테고리 한도 64KB, 암호화하며 더 커짐) 나눠 보낸다.
+// 화면 복원뿐 아니라 평소 출력도 반드시 이 크기로 나눠야 한다 — 한 덩이로 보내면 출력이 조금만 몰려도
+// (빌드 로그·Claude Code 전체 다시 그리기 등) 프레임이 한도를 넘어 통째로 거부되고, 그 세션은 그 뒤로
+// 아무 화면도 못 받는다. 폰에는 "검은 화면에 글자 하나 없는" 상태로 보인다 (제보).
 const RESTORE_CHUNK = 12 * 1024;
+// 전송이 막혀 밀린 출력이 이만큼을 넘으면, 밀린 것을 하나하나 따라 보내는 대신 지금 화면을 통째로
+// 다시 보낸다 — 사용자가 보게 될 최종 화면은 어차피 같고, 훨씬 빨리 따라잡는다.
+const MAX_PENDING_OUTPUT = 256 * 1024;
 // 출력 전송 최소 간격. "마지막 전송 후 이 간격이 지났으면 바로 보내고, 아니면 그만큼만 기다렸다 모아서
 // 보낸다"(leading-edge 스로틀). 예전엔 문서의 "최소 100ms" 를 보수적으로 잡아 120ms 로 뒀는데, 실측해보니
 // 서버가 40회 연속 전송도 거부 없이 받아줬고 이 값이 타이핑 체감 지연의 주범이었음(입력·출력 양쪽에서
@@ -184,25 +190,48 @@ export async function runAgent(options) {
     };
     const flush = async (session) => {
         session.pendingFlush = null;
-        if (!session.outBuffer)
+        if (session.flushing || !session.outBuffer)
             return;
         const chunk = session.outBuffer;
         session.outBuffer = '';
+        // 전송이 계속 막혀 밀린 양이 감당 못 할 만큼 커졌으면, 밀린 것을 하나하나 따라 보내는 대신
+        // 지금 화면을 통째로 다시 보낸다. 화면 상태는 이쪽(session.screen)에 그대로 들고 있다.
+        if (chunk.length > MAX_PENDING_OUTPUT) {
+            console.error(`밀린 출력이 너무 많아요(${Math.round(chunk.length / 1024)}KB) — 화면을 통째로 다시 보낼게요.`);
+            if (!session.closing)
+                void sendRestore(session);
+            return;
+        }
+        session.flushing = true;
         session.lastSentAt = Date.now();
         await enqueueSend(session, async () => {
             try {
-                await channel.send({
-                    kind: 'output',
-                    to: session.deviceId,
-                    data: encryptFrame(chunk, session.frameKey),
-                }, { includeSelf: false });
+                // 프레임 한도를 넘지 않도록 나눠 보낸다 (한 덩이로 보내면 통째로 거부돼 화면이 멈춘다)
+                for (let i = 0; i < chunk.length; i += RESTORE_CHUNK) {
+                    const part = chunk.slice(i, i + RESTORE_CHUNK);
+                    try {
+                        await channel.send({
+                            kind: 'output',
+                            to: session.deviceId,
+                            data: encryptFrame(part, session.frameKey),
+                        }, { includeSelf: false });
+                    }
+                    catch (err) {
+                        // 실패한 출력을 그냥 버리면 폰 화면이 깨진 채로 남으니, 실패한 자리부터 뒤쪽 전부를
+                        // 다음 전송 앞에 다시 붙여 순서대로 재시도한다
+                        session.outBuffer = chunk.slice(i) + session.outBuffer;
+                        session.sendPenaltyUntil = Date.now() + SEND_PENALTY_MS;
+                        console.error('출력 전송 실패, 다시 시도해요:', err.message);
+                        break;
+                    }
+                }
             }
-            catch (err) {
-                // 실패한 출력을 그냥 버리면 폰 화면이 깨진 채로 남으니, 다음 전송 앞에 다시 붙여 순서대로 재시도한다
-                session.outBuffer = chunk + session.outBuffer;
-                session.sendPenaltyUntil = Date.now() + SEND_PENALTY_MS;
-                console.error('출력 전송 실패, 다시 시도해요:', err.message);
-                if (!session.closing)
+            finally {
+                // 무슨 일이 있어도 표시는 반드시 푼다 — 여기 걸린 채로 남으면 그 세션은 그 뒤로
+                // 아무 화면도 못 보낸다 (지금 고치려는 바로 그 증상)
+                session.flushing = false;
+                // 남은 것(재시도분·보내는 사이에 새로 나온 것)이 있으면 이어서 보낸다
+                if (session.outBuffer && !session.closing)
                     scheduleFlush(session);
             }
         });
@@ -231,6 +260,7 @@ export async function runAgent(options) {
                     session.pendingFlush = null;
                 }
                 session.outBuffer = '';
+                session.flushing = false;
                 let snapshot;
                 try {
                     snapshot = session.serializer.serialize({ scrollback: RESTORE_SCROLLBACK_LINES });
@@ -256,7 +286,7 @@ export async function runAgent(options) {
         }
     };
     const scheduleFlush = (session) => {
-        if (session.pendingFlush !== null)
+        if (session.pendingFlush !== null || session.flushing)
             return;
         const interval = Date.now() < session.sendPenaltyUntil ? PENALTY_INTERVAL_MS : MIN_SEND_INTERVAL_MS;
         const wait = Math.max(0, interval - (Date.now() - session.lastSentAt));
@@ -377,6 +407,7 @@ export async function runAgent(options) {
             inputApproved: false,
             approvalInFlight: false,
             outBuffer: '',
+            flushing: false,
             sendChain: Promise.resolve(),
             restoring: false,
             restoreAgain: false,
@@ -792,7 +823,7 @@ export async function runAgent(options) {
             });
             return;
         }
-        // 폴더 찾기에서 이름 바꾸기 / 지우기. 어느 쪽이든 끝나면 **새 목록**을 돌려줘서
+        // 폴더 찾기에서 새로 만들기 / 이름 바꾸기 / 지우기. 무엇이든 끝나면 **새 목록**을 돌려줘서
         // 폰 화면이 곧바로 최신 상태가 되게 한다 (실패 사유도 그 목록에 실어 보낸다).
         if (frame.kind === 'path_action') {
             const control = readControl(frame.data, session.frameKey);
@@ -801,16 +832,32 @@ export async function runAgent(options) {
             const dir = typeof control.dir === 'string' && control.dir ? control.dir : liveCwd(session);
             const name = typeof control.name === 'string' ? control.name : '';
             let failure;
+            // 내용물이 든 폴더는 바로 지우지 않고 개수만 돌려준다 — 폰이 한 번 더 물어본 뒤
+            // recursive 로 다시 부른다 (browse.ts 의 deleteEntry 설명 참고)
+            let pending;
             if (control.op === 'rename') {
                 const to = typeof control.to === 'string' ? control.to : '';
                 failure = renameEntry(dir, name, to).error;
                 if (!failure)
                     console.log(`📱 폰에서 이름을 바꿨어요: ${name} → ${to} (${dir})`);
             }
+            else if (control.op === 'create') {
+                // 「＋ 새로 만들기」 — 빈 파일이나 빈 폴더 하나. 이미 있는 이름이면 만들지 않는다.
+                const kind = control.kind === 'folder' ? 'folder' : 'file';
+                failure = createEntry(dir, name, kind).error;
+                if (!failure) {
+                    console.log(`📱 폰에서 ${kind === 'folder' ? '폴더' : '파일'}를 만들었어요: ${name} (${dir})`);
+                }
+            }
             else if (control.op === 'delete') {
-                failure = deleteEntry(dir, name).error;
-                if (!failure)
-                    console.log(`📱 폰에서 지웠어요: ${name} (${dir})`);
+                const recursive = control.recursive === true;
+                const result = deleteEntry(dir, name, { recursive, protect: liveCwd(session) });
+                failure = result.error;
+                if (result.contains !== undefined)
+                    pending = { name, contains: result.contains };
+                if (!failure && !pending) {
+                    console.log(`📱 폰에서 지웠어요: ${name}${recursive ? ' (통째로)' : ''} (${dir})`);
+                }
             }
             else {
                 failure = '알 수 없는 요청이에요.';
@@ -819,7 +866,11 @@ export async function runAgent(options) {
             void send({
                 kind: 'dirs',
                 to: session.deviceId,
-                data: encryptFrame(JSON.stringify(failure ? { ...listing, error: failure } : listing), session.frameKey),
+                data: encryptFrame(JSON.stringify({
+                    ...listing,
+                    ...(failure ? { error: failure } : {}),
+                    ...(pending ? { pending } : {}),
+                }), session.frameKey),
             });
             return;
         }

package/dist/browse.js

@@ -36,10 +36,35 @@ export function renameEntry(dir, name, to) {
         return { error: `이름을 바꾸지 못했어요: ${err.message}` };
     }
 }
+// 새로 만들기 — 지금 보고 있는 폴더 안에 빈 파일이나 빈 폴더를 하나 만든다.
+// 이미 있는 이름은 절대 덮어쓰지 않는다 (내용이 날아가면 되돌릴 수 없다).
+export function createEntry(dir, name, kind) {
+    const target = childPath(dir, name);
+    if (!target)
+        return { error: '이름에 「/」 나 「..」 은 쓸 수 없어요.' };
+    if (fs.existsSync(target))
+        return { error: `"${name}" 는 이미 있어요.` };
+    try {
+        if (kind === 'folder') {
+            fs.mkdirSync(target);
+        }
+        else {
+            // wx = 이미 있으면 실패 — 위에서 한 번 봤지만 그 사이에 생겼을 수도 있어서 한 겹 더 막는다
+            fs.writeFileSync(target, '', { flag: 'wx' });
+        }
+        return {};
+    }
+    catch (err) {
+        return { error: `만들지 못했어요: ${err.message}` };
+    }
+}
 // 지우기 — 파일은 바로, 폴더는 **비어 있을 때만**.
 // 폰에서 한 번 잘못 누르면 되돌릴 수 없으므로, 안에 든 것까지 통째로 지우는 일은 하지 않는다
 // (정말 필요하면 터미널에서 직접 지우면 된다).
-export function deleteEntry(dir, name) {
+// 지우기. 폴더 안에 뭐가 들어 있으면 바로 지우지 않고 `contains`(들어 있는 개수)만 돌려준다 —
+// 폰에서 "안에 N개가 들어 있어요. 통째로 지울까요?" 를 한 번 더 물어본 뒤 recursive 로 다시 부른다.
+// (예전에는 여기서 그냥 거절했는데, 그러면 내용물 있는 폴더는 영영 정리할 수 없었다)
+export function deleteEntry(dir, name, opts = {}) {
     const target = childPath(dir, name);
     if (!target)
         return { error: '지울 수 없는 이름이에요.' };
@@ -50,13 +75,17 @@ export function deleteEntry(dir, name) {
     catch {
         return { error: '이미 없어요.' };
     }
+    // 지금 터미널이 그 안에서 돌고 있는 폴더는 못 지운다 — 지우면 셸이 갈 곳을 잃는다
+    if (opts.protect && stat.isDirectory() && isInside(opts.protect, target)) {
+        return { error: `지금 터미널이 "${name}" 안에서 돌고 있어요. 밖으로 나온 뒤 지워주세요.` };
+    }
     try {
         if (stat.isDirectory()) {
             const inside = fs.readdirSync(target);
-            if (inside.length > 0) {
-                return { error: `"${name}" 안에 ${inside.length}개가 들어 있어서 여기서는 못 지워요.` };
+            if (inside.length > 0 && !opts.recursive) {
+                return { contains: inside.length };
             }
-            fs.rmdirSync(target);
+            fs.rmSync(target, { recursive: true, force: true });
             return {};
         }
         fs.unlinkSync(target);
@@ -66,6 +95,12 @@ export function deleteEntry(dir, name) {
         return { error: `지우지 못했어요: ${err.message}` };
     }
 }
+// child 가 parent 와 같거나 그 아래에 있는가
+function isInside(child, parent) {
+    const a = path.resolve(child);
+    const b = path.resolve(parent);
+    return a === b || a.startsWith(b.endsWith(path.sep) ? b : b + path.sep);
+}
 export function listDirs(dir, opts = {}) {
     const target = path.resolve(dir);
     const up = path.dirname(target);

package/package.json

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