shellbase 0.1.6 → 0.1.8

package/README.md

@@ -45,8 +45,33 @@ shellbase start --dir ~/projects/my-app --name "내 노트북"
 
 터미널을 새로 열어서 다른 폴더로 `shellbase start` 를 한 번 더 실행하면, 별개의 세션으로 등록돼서
 폰 목록에 폴더별로 따로 떠요(예: `내PC · project-a`, `내PC · project-b`). 프로젝트마다 세션을 하나씩
-켜두고 폰에서 왔다갔다 접속할 수 있어요. `Ctrl+C` 로 정상 종료하면 그 세션은 목록에서 자동으로
-지워지고, 강제 종료 등으로 남아있는 세션은 폰 목록에서 휴지통 아이콘으로 직접 지울 수 있어요.
+켜두고 폰에서 왔다갔다 접속할 수 있어요.
+
+### 폰에서 세션 열기 · 전환 · 끄기 (컴퓨터에 손 안 대고)
+
+세션이 **하나라도 켜져 있으면**, 그다음부터는 폰에서 전부 할 수 있어요.
+
+| 하고 싶은 것 | 폰에서 하는 법 |
+|---|---|
+| 세션 하나 더 열기 | 목록 화면의 **`+ 새 세션`** → 폴더 고르고 열기 (켜져 있는 세션이 그 컴퓨터에서 하나 더 띄워줘요) |
+| 세션 갈아타기 | 터미널 화면 위쪽의 **기기 이름(▾)** 탭 → 원하는 세션 선택 |
+| 세션 끄기 | 목록의 **전원 아이콘**, 또는 터미널 화면의 기기 이름(▾) → **이 세션 끄기** |
+| 화면만 닫기 | `← 목록` 으로 나가기 — 컴퓨터의 세션은 계속 살아있어요 |
+
+- **끄기는 진짜로 꺼요.** 컴퓨터에서 돌아가던 그 터미널이 종료되고 목록에서도 자동으로 사라져요
+  (`Ctrl+C` 를 누른 것과 같아요). 프로세스가 죽었는데 목록에만 남아있는 항목은 휴지통 아이콘으로
+  지울 수 있어요 — 그건 목록만 정리하는 버튼이에요.
+- **폰에서 연 세션은 자동 승인으로 열려요.** 컴퓨터 앞에 `y` 를 눌러줄 사람이 없기 때문이에요.
+  (요청을 보낸 쪽이 그 세션의 암호화 키를 가지고 있는지 먼저 확인해요 — 그 키는 내 계정만 읽을 수
+  있어서, 다른 사람은 남의 세션을 열거나 끌 수 없어요.)
+- **폰에서 연 세션은 부모 세션과 독립적이에요.** 처음 켠 세션을 `Ctrl+C` 로 꺼도 폰에서 만든 세션은
+  계속 살아있어요 (각각 폰에서 따로 끄면 돼요).
+
+> ⚠️ **도커로 띄운 세션을 폰에서 끄면 도커가 다시 살려요.** `--restart unless-stopped` 는 정상 종료
+> (exit 0)에도 컨테이너를 자동 재시작하거든요(실제로 확인한 동작이에요). 그래서 도커로 돌리는 그
+> 세션은 폰에서 끄면 **사실상 재시작**이 되고, 새 이름의 세션으로 목록에 다시 나타나요. 완전히
+> 내리려면 컴퓨터에서 `docker stop shellbase-agent` 를 쓰세요. 폰에서 `+ 새 세션` 으로 만든 세션들은
+> 도커와 무관한 일반 프로세스라 폰에서 끄면 그대로 꺼져요.
 
 ## 참고
 

package/dist/config.js

@@ -11,3 +11,7 @@ export const CLI_AUTH_SESSIONS_TABLE_ID = '01a00aa0-802d-7730-88ba-b831b7405188'
 export const WEB_LOGIN_URL = 'https://shellbase.web.connectbase.world/login';
 export const CONFIG_DIR = path.join(os.homedir(), '.shellbase');
 export const CREDENTIALS_PATH = path.join(CONFIG_DIR, 'credentials.json');
+// 폰이 보내는 제어 프레임(세션 끄기 / 새 세션 열기)에 함께 실어 보내는 확인 문자열.
+// 프레임 전체가 세션별 키로 암호화돼 있어서, 이 문자열이 제대로 풀린다는 건 보낸 쪽이 그 키
+// (= devices 테이블의 내 row, RLS 로 주인만 읽을 수 있음)를 가지고 있었다는 증거가 된다.
+export const CONTROL_TOKEN = 'shellbase-control-v1';

package/dist/session.js

@@ -3,12 +3,13 @@ import os from 'node:os';
 import crypto from 'node:crypto';
 import * as pty from 'node-pty';
 import { requireClient } from './auth.js';
-import { TERMINAL_CATEGORY } from './config.js';
+import { TERMINAL_CATEGORY, CONTROL_TOKEN } from './config.js';
 import { startSleepGuard, stopSleepGuard } from './sleep-guard.js';
 import { encryptFrame, decryptFrame, generateFrameKey } from './crypto.js';
 import { registerDevice, heartbeatDevice, unregisterDevice } from './devices.js';
 import { promptApproval } from './prompt.js';
 import { touchRecentDir } from './recent-dirs.js';
+import { spawnSession } from './spawner.js';
 const HEARTBEAT_MS = 20_000;
 const APPROVAL_TIMEOUT_MS = 30_000;
 const SCROLLBACK_MAX = 16_000;
@@ -17,6 +18,22 @@ function resolveShell() {
         return process.env.COMSPEC ?? 'powershell.exe';
     return process.env.SHELL ?? '/bin/bash';
 }
+// 폰이 보내는 제어 프레임(끄기 / 새 세션)은 이 세션의 암호화 키로 풀려야만 받아들인다.
+// 키는 devices 테이블의 내 row 에만 있고 RLS 로 주인만 읽을 수 있으니, 복호화에 성공했다는 것
+// 자체가 "주인이 보낸 요청"이라는 증거가 된다 (입력 승인과 별개 — 승인은 타이핑 권한용).
+function readControl(data, key) {
+    if (typeof data !== 'string')
+        return null;
+    try {
+        const parsed = JSON.parse(decryptFrame(data, key));
+        if (!parsed || parsed.token !== CONTROL_TOKEN)
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
 export async function startSession(options) {
     const { cb, memberId } = await requireClient();
     const cwd = options.dir ? path.resolve(options.dir) : process.cwd();
@@ -41,17 +58,6 @@ export async function startSession(options) {
     if (autoApprove) {
         console.log(`⚠️  자동 승인이 켜져 있어요${accountAutoApprove ? ' (계정 설정)' : ' (--auto-approve)'} — 접속 요청을 묻지 않고 자동 승인해요. 내 계정에 들어올 수 있는 사람은 누구나 곧바로 입력할 수 있어요.`);
     }
-    const deviceRowId = await registerDevice(cb, {
-        ownerId: memberId,
-        deviceId: device.deviceId,
-        deviceName,
-        cwd,
-        frameKey: device.frameKey,
-        favoriteDirs: touchRecentDir(cwd),
-    });
-    const heartbeat = setInterval(() => {
-        heartbeatDevice(cb, deviceRowId).catch((err) => console.error('하트비트 실패:', err.message));
-    }, HEARTBEAT_MS);
     await cb.realtime.connect({ userId: device.deviceId });
     const channel = await cb.realtime.subscribe(TERMINAL_CATEGORY);
     // 이 채널은 앱의 모든 멤버가 공유하므로, 프레임 내용(data)은 기기별 키로 암호화해서 주고받는다.
@@ -65,14 +71,21 @@ export async function startSession(options) {
         env: process.env,
     });
     // PTY 출력은 모아서 전송 — 서버가 전송 속도를 최소 100ms 간격으로 제한해서(RATE_LIMITED), 그보다
-    // 짧은 간격으로 보내면 출력이 많은 순간(로그 스크롤 등)에 전송이 거부될 수 있음. 메시지 수/요금
-    // 절감 목적도 있지만, 이제는 이 제한을 지키는 게 우선.
+    // 짧은 간격으로 보내면 출력이 많은 순간(로그 스크롤 등)에 전송이 거부될 수 있음. 그렇다고 매번
+    // 고정 간격을 기다리면 한두 글자짜리 출력도 불필요하게 지연되니, "마지막 전송 후 이 간격이
+    // 지났으면 바로 보내고, 아니면 그만큼만 기다렸다 모아서 보낸다" 방식으로 평소 지연은 최소화하고
+    // 출력이 몰릴 때만 자동으로 묶이게 한다.
+    const MIN_SEND_INTERVAL_MS = 120;
     let outBuffer = '';
+    let lastSentAt = 0;
+    let pendingFlush = null;
     const flush = async () => {
+        pendingFlush = null;
         if (!outBuffer)
             return;
         const chunk = outBuffer;
         outBuffer = '';
+        lastSentAt = Date.now();
         try {
             await channel.send({
                 kind: 'output',
@@ -84,12 +97,18 @@ export async function startSession(options) {
             console.error('출력 전송 실패:', err.message);
         }
     };
-    const flushTimer = setInterval(() => void flush(), 120);
+    const scheduleFlush = () => {
+        if (pendingFlush !== null)
+            return;
+        const wait = Math.max(0, MIN_SEND_INTERVAL_MS - (Date.now() - lastSentAt));
+        pendingFlush = setTimeout(() => void flush(), wait);
+    };
     // 최근 출력을 조금 들고 있다가, 모바일이 (재)접속했을 때 놓친 화면 대신 다시 보여줌
     let scrollback = '';
     ptyProcess.onData((data) => {
         outBuffer += data;
         scrollback = (scrollback + data).slice(-SCROLLBACK_MAX);
+        scheduleFlush();
     });
     // 모바일이 접속을 시도하면 데스크톱에서 승인해야만 입력이 먹힘 (읽기/출력은 항상 흐름 —
     // 이미 같은 계정으로 로그인했다는 전제이므로, 승인은 "지금 이 순간 내가 타이핑을 넘겨줄지"
@@ -123,6 +142,34 @@ export async function startSession(options) {
                 .catch((err) => console.error('접속 승인 처리 실패:', err.message));
             return;
         }
+        // 폰에서 "이 세션 끄기" — 정상 종료 경로(shutdown)를 그대로 타서 목록에서도 스스로 지워진다.
+        if (frame.kind === 'kill') {
+            if (!readControl(frame.data, device.frameKey))
+                return;
+            console.log('\n📱 폰에서 이 세션을 끄라고 요청했어요 — 정리하고 종료할게요.');
+            void shutdown();
+            return;
+        }
+        // 폰에서 "새 세션 열기" — 이 세션이 CLI 를 한 번 더 띄워주고, 새 세션은 폰 목록에 따로 나타난다.
+        if (frame.kind === 'new_session') {
+            const control = readControl(frame.data, device.frameKey);
+            if (!control || typeof control.dir !== 'string')
+                return;
+            const result = spawnSession(control.dir);
+            if (result.ok) {
+                console.log(`\n📱 폰 요청으로 새 세션을 열었어요 (${control.dir})`);
+                return;
+            }
+            console.error(`\n📱 폰이 요청한 새 세션을 못 열었어요: ${result.reason}`);
+            channel
+                .send({
+                kind: 'new_session_failed',
+                to: device.deviceId,
+                data: encryptFrame(result.reason, device.frameKey),
+            }, { includeSelf: false })
+                .catch((err) => console.error('실패 알림 전송 실패:', err.message));
+            return;
+        }
         if (frame.kind === 'input' && typeof frame.data === 'string') {
             if (!inputApproved)
                 return;
@@ -137,13 +184,28 @@ export async function startSession(options) {
             ptyProcess.resize(frame.cols, frame.rows);
         }
     });
+    // 목록 등록은 "이제 프레임을 받을 수 있다"가 확실해진 지금(구독 + 메시지 핸들러 준비 완료) 한다.
+    // 예전엔 실시간 연결보다 먼저 등록해서, 폰이 목록에 뜨자마자 보낸 요청(특히 "세션 끄기")이
+    // 아직 구독 전인 세션에 닿지 못하고 그대로 사라지는 구간이 있었음 (실시간 프레임은 저장되지 않음).
+    const deviceRowId = await registerDevice(cb, {
+        ownerId: memberId,
+        deviceId: device.deviceId,
+        deviceName,
+        cwd,
+        frameKey: device.frameKey,
+        favoriteDirs: touchRecentDir(cwd),
+    });
+    const heartbeat = setInterval(() => {
+        heartbeatDevice(cb, deviceRowId).catch((err) => console.error('하트비트 실패:', err.message));
+    }, HEARTBEAT_MS);
     startSleepGuard();
     let shuttingDown = false;
     const shutdown = async () => {
         if (shuttingDown)
             return;
         shuttingDown = true;
-        clearInterval(flushTimer);
+        if (pendingFlush !== null)
+            clearTimeout(pendingFlush);
         clearInterval(heartbeat);
         await flush();
         stopMessages();

package/dist/spawner.js

@@ -0,0 +1,43 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+// `shellbase` 는 bin 심볼릭 링크(예: /usr/local/bin/shellbase)로 실행되기도 하고 dist/cli.js 로
+// 직접 실행되기도 해서, 지금 돌아가는 진입점(process.argv[1])을 그대로 다시 쓰는 게 가장 확실하다.
+// 그게 비어있는 예외적인 경우에만 이 파일 옆의 cli.js 로 되돌아간다.
+function resolveEntry() {
+    const current = process.argv[1];
+    if (current && fs.existsSync(current))
+        return current;
+    return path.join(path.dirname(fileURLToPath(import.meta.url)), 'cli.js');
+}
+export function spawnSession(dir) {
+    const target = path.resolve(dir);
+    let stat;
+    try {
+        stat = fs.statSync(target);
+    }
+    catch {
+        return { ok: false, reason: `그런 폴더가 없어요: ${target}` };
+    }
+    if (!stat.isDirectory())
+        return { ok: false, reason: `폴더가 아니라 파일이에요: ${target}` };
+    try {
+        // 폰에서 띄우는 세션은 승인 물음에 대답할 터미널이 없다(stdio: 'ignore') — 그대로 두면 30초 뒤
+        // 자동 거부돼서 화면만 보이고 타이핑이 안 되는 세션이 된다. 요청을 보낸 쪽은 이미 이 세션의
+        // 암호화 키(주인만 읽을 수 있는 devices row)를 가지고 있음이 확인된 상태라 자동 승인으로 띄운다.
+        const child = spawn(process.execPath, [resolveEntry(), 'start', '--dir', target, '--auto-approve'], {
+            cwd: target,
+            env: process.env,
+            // 부모 세션을 Ctrl+C 로 껐을 때 폰에서 따로 만든 세션까지 같이 죽지 않도록 독립 프로세스로 띄움
+            // (각 세션은 폰 목록에서 개별적으로 끌 수 있음). 도커 컨테이너 안이라면 컨테이너가 멈출 때 함께 정리됨.
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.unref();
+        return { ok: true };
+    }
+    catch (err) {
+        return { ok: false, reason: err.message };
+    }
+}

package/package.json

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