shellbase 0.9.1 → 0.11.0

package/README.md

@@ -117,6 +117,7 @@ shellbase start --no-restore     # 복구하지 않고 이 폴더 세션 하나
 | 하고 싶은 것 | 폰에서 하는 법 |
 |---|---|
 | 세션 하나 더 열기 | 목록 화면의 **`+ 새 세션`**, 또는 터미널 화면의 기기 이름(▾) → **`+ 이 컴퓨터에서 새 세션 열기`** (열리면 그 세션으로 바로 넘어가요) |
+| 잠깐 쓸 터미널 열기 | 터미널 화면 위쪽의 **`+ 임시 터미널`** — 지금 폴더에 하나 더 띄워요 (목록에 안 남고, 나가면 사라져요) |
 | 세션 갈아타기 | 터미널 화면 위쪽의 **기기 이름(▾)** 탭 → 원하는 세션 선택 |
 | 세션 끄기 | 목록의 **전원 아이콘**, 또는 터미널 화면의 기기 이름(▾) → **이 세션 끄기** |
 | 화면만 닫기 | `← 목록` 으로 나가기 — 컴퓨터의 세션은 계속 살아있어요 |
@@ -132,6 +133,20 @@ shellbase start --no-restore     # 복구하지 않고 이 폴더 세션 하나
   종료돼요(그 대신 다음 실행 때 자동 복구됩니다). 세션을 하나만 끄고 싶으면 폰에서 그 세션의 `✕` 를
   쓰세요 — 나머지 세션은 그대로 유지돼요.
 
+### 임시 터미널 (0.10.0+)
+
+Claude Code 가 화면을 꽉 채우고 있을 때 `git status` 같은 걸 잠깐 쳐보려고 터미널을 하나 더 열곤 하는데,
+그렇게 연 터미널이 목록에 계속 쌓이는 게 문제였어요. 터미널 화면 위쪽의 **`+ 임시 터미널`** 로 연 것은
+**한 번 쓰고 버리는** 터미널이에요.
+
+- 세션 목록에도, 상단 칩 줄에도 **안 보여요** (지금 보고 있는 동안만 칩으로 보입니다)
+- 그 화면에서 나가면 **스스로 종료**돼요 — 다만 **방금까지 뭔가 돌고 있었으면 끄지 않고 목록에 남깁니다**
+  (하던 일이 조용히 사라지면 안 되니까요)
+- 컴퓨터를 재시작해도 **되살아나지 않아요** (정식 세션만 복구 대상)
+- 브라우저를 그냥 닫아버린 경우엔, 아무도 안 보고 화면도 조용한 채로 **5분**이 지나면 컴퓨터가 알아서 정리해요
+- 계속 쓰고 싶어지면 **`임시 · 계속 쓰기`** 를 누르세요 — 정식 세션이 되고 이름의 `(임시)` 표시도 떨어져요
+- 임시 터미널에는 **Claude 자동 시작이 적용되지 않아요** (명령 하나 치려고 여는 것이라 빈 터미널로 열립니다)
+
 ### 파일 보기·편집
 
 `📁 폴더 찾기` 목록에는 폴더와 함께 **파일**도 나와요. 파일을 탭하면 편집기가 열리고, 고친 뒤 `저장` 을

package/dist/agent.js

@@ -12,17 +12,23 @@ import { requireClient } from './auth.js';
 import { TERMINAL_CATEGORY, CONTROL_TOKEN, SESSION_ENV } from './config.js';
 import { startSleepGuard, stopSleepGuard } from './sleep-guard.js';
 import { encryptFrame, decryptFrame, generateFrameKey } from './crypto.js';
-import { registerDevice, heartbeatDevice, unregisterDevice, listOnlineNames, renameDevice, markSessionDone, } from './devices.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 } 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';
+import { pushSessionDone } from './push.js';
 import { IMAGE_CHUNK_TTL_MS, pruneImages, saveImage } from './images.js';
 import { watchDoneNotes } from './notify.js';
 import { hookAsked, hookState, installHook, rememberHookAsked } from './claude-hook.js';
 const HEARTBEAT_MS = 20_000;
+// 임시 터미널 정리 — 보는 사람도 없고(폰에서 아무 신호도 없고) 화면도 조용한 채로 이만큼 지나면 닫는다.
+// 폰은 보고 있는 동안 10초마다 신호(ping)를 보내므로, 앱을 닫거나 다른 세션으로 넘어가면 신호가 끊긴다.
+// 5분이나 두는 이유: 폰 화면이 잠기면 타이머가 멈춰서 신호도 잠깐 끊기기 때문 (잠깐 자리를 비운 것과 구분).
+const TEMP_ORPHAN_MS = 5 * 60 * 1000;
+const TEMP_SWEEP_MS = 60 * 1000;
 // 올린 사진 정리 주기 — 보관 기한이 하루라, 오래 켜둔 컴퓨터에서도 반나절 안에 치워진다
 const IMAGE_SWEEP_MS = 6 * 60 * 60 * 1000;
 const APPROVAL_TIMEOUT_MS = 30_000;
@@ -157,7 +163,8 @@ export async function runAgent(options) {
     }
     function persistOpenSessions() {
         saveOpenSessions([...sessions.values()]
-            .filter((session) => !session.closing)
+            // 임시 터미널은 재시작 후 되살리지 않는다 — 한 번 쓰고 버리는 것이므로
+            .filter((session) => !session.closing && !session.temporary)
             .map((session) => ({ dir: session.cwd, name: session.name })));
     }
     const send = async (frame) => {
@@ -256,10 +263,11 @@ export async function runAgent(options) {
         session.pendingFlush = setTimeout(() => void flush(session), wait);
     };
     // ── 작업 완료 알림 ──────────────────────────────────────────────────────────
-    // 폰에 두 가지 방법으로 알린다:
+    // 폰에 세 가지 방법으로 알린다:
     //   ① 실시간 신호 — 앱을 켜두고 있으면 곧바로 뜬다
     //   ② 목록 row 의 done_at — 나중에 앱을 열어봐도 "그 사이에 끝났다" 는 표시가 남아 있다
-    // ②가 없으면 폰이 꺼져 있던 동안 끝난 작업을 영영 모르게 되므로 둘 다 남긴다.
+    //   ③ 푸시 — 앱을 완전히 닫아둔 폰에도 알림이 뜬다 (이 제품의 핵심: 자리를 안 지켜도 된다)
+    // ①만 있으면 앱을 켜두고 지켜봐야 하고, ②만 있으면 직접 열어봐야 알 수 있다.
     const announceDone = (session, why) => {
         if (session.closing)
             return;
@@ -271,6 +279,8 @@ export async function runAgent(options) {
                 // 목록에 못 남겨도 실시간 신호는 이미 갔다 — 세션 동작에는 영향 없음
             });
         }
+        // 발송은 서버 함수가 한다 (push.ts 설명 참고). 함수가 없는 계정에서도 조용히 넘어간다.
+        void pushSessionDone(cb, { deviceId: session.deviceId, name: session.name });
     };
     // 출력이 이어지는지 끊겼는지를 따라가며, 조용해지는 순간을 잡는다 (규칙은 위 상수 설명 참고)
     const trackBusy = (session, bytes) => {
@@ -322,7 +332,8 @@ export async function runAgent(options) {
             console.error('접속 승인 처리 실패:', err.message);
         });
     }
-    async function createSession(dir, explicitName) {
+    async function createSession(dir, explicitName, opts = {}) {
+        const temporary = opts.temporary === true;
         const cwd = path.resolve(dir);
         if (sessions.size >= MAX_SESSIONS) {
             throw new Error(`세션은 한 번에 최대 ${MAX_SESSIONS}개까지 열 수 있어요.`);
@@ -341,7 +352,9 @@ export async function runAgent(options) {
         const session = {
             deviceId,
             frameKey: generateFrameKey(),
-            name: explicitName ?? defaultName(cwd),
+            // 임시 터미널은 이름만 봐도 알 수 있게 (임시) 를 붙인다 — 목록에는 안 뜨지만
+            // 그 터미널을 보고 있는 동안 상단 칩에는 이 이름이 그대로 보인다
+            name: explicitName ?? (temporary ? `${defaultName(cwd)} (임시)` : defaultName(cwd)),
             cwd,
             rowId: '',
             pty: pty.spawn(shell, [], {
@@ -377,6 +390,8 @@ export async function runAgent(options) {
             idleTimer: null,
             announcedFor: 0,
             hookSeen: false,
+            temporary,
+            viewerSeenAt: Date.now(),
         };
         session.screen.loadAddon(session.serializer);
         session.pty.onData((data) => {
@@ -401,6 +416,7 @@ export async function runAgent(options) {
                 cwd,
                 frameKey: session.frameKey,
                 favoriteDirs: touchRecentDir(cwd),
+                temporary,
             });
         }
         catch (err) {
@@ -454,6 +470,7 @@ export async function runAgent(options) {
         shuttingDown = true;
         clearInterval(heartbeat);
         clearInterval(imageSweep);
+        clearInterval(tempSweep);
         stopNotes();
         for (const session of [...sessions.values()]) {
             session.closing = true;
@@ -515,6 +532,8 @@ export async function runAgent(options) {
         const session = sessions.get(frame.to);
         if (!session || session.closing)
             return;
+        // 폰에서 온 프레임 = 누군가 이 세션을 보고 있다는 뜻 (임시 터미널 정리 판단에 쓴다)
+        session.viewerSeenAt = Date.now();
         if (frame.kind === 'connect_request') {
             // 화면 보기는 승인 여부와 무관하게 항상 되므로, 승인을 묻기 전에 지금 화면부터 그대로 복원해준다
             void sendRestore(session);
@@ -542,6 +561,27 @@ export async function runAgent(options) {
             void closeSession(session, { deliberate: true });
             return;
         }
+        // 임시 터미널을 정식 세션으로 — 목록에 나타나고, 재시작해도 되살아나고, 스스로 정리되지 않는다
+        if (frame.kind === 'keep_session') {
+            if (!readControl(frame.data, session.frameKey))
+                return;
+            if (!session.temporary)
+                return;
+            const before = session.name;
+            session.temporary = false;
+            session.name = session.name.replace(/ \(임시\)$/, '');
+            keepDevice(cb, session.rowId, session.name)
+                .then(() => {
+                persistOpenSessions();
+                console.log(`📱 "${before}" 를 계속 쓰기로 바꿨어요 — 이제 목록에 남습니다.`);
+            })
+                .catch((err) => {
+                session.temporary = true;
+                session.name = before;
+                console.error('계속 쓰기 전환 실패:', err.message);
+            });
+            return;
+        }
         // 폰에서 세션 이름 바꾸기 — 컴퓨터를 가리키는 앞부분은 유지해서 목록의 컴퓨터 묶음이 깨지지 않게 한다
         if (frame.kind === 'rename') {
             const control = readControl(frame.data, session.frameKey);
@@ -757,10 +797,12 @@ export async function runAgent(options) {
             if (!control || typeof control.dir !== 'string')
                 return;
             const dir = control.dir;
+            // 폰의 「+ 터미널」 은 임시로, 「여기서 새 세션」 은 정식 세션으로 연다
+            const temporary = control.temporary === true;
             void (async () => {
                 try {
-                    const created = await createSession(dir);
-                    console.log(`\n📱 폰 요청으로 새 세션을 열었어요: "${created.name}" (${created.cwd})`);
+                    const created = await createSession(dir, undefined, { temporary });
+                    console.log(`\n📱 폰 요청으로 ${temporary ? '임시 ' : ''}세션을 열었어요: "${created.name}" (${created.cwd})`);
                 }
                 catch (err) {
                     const reason = err.message;
@@ -796,6 +838,22 @@ export async function runAgent(options) {
             }
         }
     });
+    // 임시 터미널 청소 — 폰이 창을 닫거나 앱이 죽어서 "끄기" 요청이 못 온 경우를 위한 안전망.
+    // (평소에는 폰이 그 터미널을 떠나는 순간 바로 끄기 요청을 보낸다)
+    const tempSweep = setInterval(() => {
+        const now = Date.now();
+        for (const session of sessions.values()) {
+            if (!session.temporary || session.closing)
+                continue;
+            if (now - session.viewerSeenAt < TEMP_ORPHAN_MS)
+                continue;
+            // 아무도 안 봐도 뭔가 돌고 있으면(출력이 계속 나오면) 끝날 때까지 기다린다
+            if (session.lastOutputAt && now - session.lastOutputAt < TEMP_ORPHAN_MS)
+                continue;
+            console.log(`🧹 임시 터미널 "${session.name}" 을(를) 아무도 안 봐서 정리해요.`);
+            void closeSession(session, { deliberate: true });
+        }
+    }, TEMP_SWEEP_MS);
     const heartbeat = setInterval(() => {
         for (const session of sessions.values()) {
             if (session.closing || !session.rowId)

package/dist/config.js

@@ -8,7 +8,10 @@ export const TERMINAL_CATEGORY = 'shellbase-terminal';
 export const DEVICES_TABLE_ID = '01a009c7-a33d-79ca-9eeb-f9dc2d442c1b';
 // CLI 구글 로그인 중계용 (google-auth.ts) — 짧게 살고 암호화된 채로만 저장됨.
 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 WEB_APP_URL = 'https://shellbase.web.connectbase.world';
+export const WEB_LOGIN_URL = `${WEB_APP_URL}/login`;
+// 앱을 닫아둔 폰에 알림을 보내주는 서버 함수 (push.ts). 발송은 서버만 할 수 있어서 이걸 부른다.
+export const PUSH_FUNCTION_ID = process.env.SHELLBASE_PUSH_FUNCTION ?? 'shellbase-notify';
 export const CONFIG_DIR = path.join(os.homedir(), '.shellbase');
 export const CREDENTIALS_PATH = path.join(CONFIG_DIR, 'credentials.json');
 // 폰이 보내는 제어 프레임(세션 끄기 / 새 세션 열기)에 함께 실어 보내는 확인 문자열.

package/dist/devices.js

@@ -11,6 +11,7 @@ export async function registerDevice(cb, params) {
             cwd: params.cwd,
             frame_key: params.frameKey,
             favorite_dirs: params.favoriteDirs,
+            temporary: params.temporary === true,
             last_seen_at: new Date().toISOString(),
         },
     });
@@ -47,6 +48,13 @@ export async function listOnlineNames(cb) {
     }
     return names;
 }
+// 임시 터미널을 "계속 쓰기" 로 바꿀 때 — 목록에 정식으로 남기고 이름에서 (임시) 표시를 뗀다.
+// 반대 방향(정식 → 임시)은 없다: 이미 쓰고 있던 터미널이 조용히 사라지는 건 사고이기 때문.
+export async function keepDevice(cb, rowId, deviceName) {
+    await cb.database.updateData(DEVICES_TABLE_ID, rowId, {
+        data: { temporary: false, device_name: deviceName },
+    });
+}
 // 폰에서 세션 이름을 바꿀 때 — 목록 row 의 표시 이름만 갱신한다 (세션 자체는 그대로 유지)
 export async function renameDevice(cb, rowId, deviceName) {
     await cb.database.updateData(DEVICES_TABLE_ID, rowId, { data: { device_name: deviceName } });

package/dist/push.js

@@ -0,0 +1,51 @@
+import { PUSH_FUNCTION_ID, WEB_APP_URL } from './config.js';
+// "앱을 완전히 닫아둔 폰"에 알림을 보내는 길.
+//
+// 발송 자체는 서버(ConnectBase Function)만 할 수 있다 — 브라우저·에이전트가 쓰는 공개키로는
+// 푸시 발송이 막혀 있기 때문(권한이 새는 걸 막으려고 SDK 가 명시적으로 차단한다).
+// 그래서 에이전트는 "끝났다"고 함수를 부르기만 하고, 누구에게 보낼지는 서버가 호출자 신원
+// (ctx.memberId)으로 판단한다. 즉 남의 폰으로는 보낼 수 없다.
+//
+// 함수가 아직 배포 안 된 계정에서도 에이전트는 멀쩡히 돌아야 하므로, 실패는 조용히 넘긴다.
+// 함수가 아직 배포 안 됐으면 매번 찔러봐야 낭비다. 그렇다고 영영 포기하면, 나중에 함수를
+// 배포해도 에이전트를 껐다 켜기 전까지 알림이 안 온다 — 그래서 "한동안 쉬었다 다시 해본다".
+let quietUntil = 0;
+let consecutiveFailures = 0;
+const GIVE_UP_AFTER = 5;
+const RETRY_AFTER_MS = 10 * 60 * 1000;
+function looksMissing(message) {
+    const lowered = message.toLowerCase();
+    return (lowered.includes('invalid function') ||
+        lowered.includes('not found') ||
+        lowered.includes('404') ||
+        lowered.includes('does not exist'));
+}
+export async function pushSessionDone(cb, params) {
+    if (Date.now() < quietUntil)
+        return;
+    if (consecutiveFailures >= GIVE_UP_AFTER) {
+        // 연달아 실패하는 중 — 잠깐 쉬었다가 처음부터 다시 세어본다
+        quietUntil = Date.now() + RETRY_AFTER_MS;
+        consecutiveFailures = 0;
+        return;
+    }
+    try {
+        await cb.functions.invoke(PUSH_FUNCTION_ID, {
+            kind: 'session_done',
+            device_id: params.deviceId,
+            name: params.name,
+            url: `${WEB_APP_URL}/session/${params.deviceId}`,
+        });
+        consecutiveFailures = 0;
+    }
+    catch (err) {
+        const message = err.message ?? '';
+        if (looksMissing(message)) {
+            // 아직 함수를 안 만든 계정 — 10분 뒤에 한 번 더 해본다 (그 사이 배포했을 수 있으므로)
+            quietUntil = Date.now() + RETRY_AFTER_MS;
+            consecutiveFailures = 0;
+            return;
+        }
+        consecutiveFailures += 1;
+    }
+}

package/package.json

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