shellbase 0.10.0 → 0.12.0

package/dist/agent.js

@@ -15,10 +15,11 @@ 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 } from './browse.js';
+import { listDirs, 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';
+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';
@@ -262,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;
@@ -277,6 +279,8 @@ export async function runAgent(options) {
                 // 목록에 못 남겨도 실시간 신호는 이미 갔다 — 세션 동작에는 영향 없음
             });
         }
+        // 발송은 서버 함수가 한다 (push.ts 설명 참고). 함수가 없는 계정에서도 조용히 넘어간다.
+        void pushSessionDone(cb, { deviceId: session.deviceId, name: session.name });
     };
     // 출력이 이어지는지 끊겼는지를 따라가며, 조용해지는 순간을 잡는다 (규칙은 위 상수 설명 참고)
     const trackBusy = (session, bytes) => {
@@ -780,7 +784,7 @@ export async function runAgent(options) {
             const control = readControl(frame.data, session.frameKey);
             if (!control)
                 return;
-            const listing = listDirs(typeof control.dir === 'string' && control.dir ? control.dir : liveCwd(session));
+            const listing = listDirs(typeof control.dir === 'string' && control.dir ? control.dir : liveCwd(session), { hidden: control.hidden === true });
             void send({
                 kind: 'dirs',
                 to: session.deviceId,
@@ -788,6 +792,37 @@ export async function runAgent(options) {
             });
             return;
         }
+        // 폴더 찾기에서 이름 바꾸기 / 지우기. 어느 쪽이든 끝나면 **새 목록**을 돌려줘서
+        // 폰 화면이 곧바로 최신 상태가 되게 한다 (실패 사유도 그 목록에 실어 보낸다).
+        if (frame.kind === 'path_action') {
+            const control = readControl(frame.data, session.frameKey);
+            if (!control)
+                return;
+            const dir = typeof control.dir === 'string' && control.dir ? control.dir : liveCwd(session);
+            const name = typeof control.name === 'string' ? control.name : '';
+            let failure;
+            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 === 'delete') {
+                failure = deleteEntry(dir, name).error;
+                if (!failure)
+                    console.log(`📱 폰에서 지웠어요: ${name} (${dir})`);
+            }
+            else {
+                failure = '알 수 없는 요청이에요.';
+            }
+            const listing = listDirs(dir, { hidden: control.hidden === true });
+            void send({
+                kind: 'dirs',
+                to: session.deviceId,
+                data: encryptFrame(JSON.stringify(failure ? { ...listing, error: failure } : listing), session.frameKey),
+            });
+            return;
+        }
         if (frame.kind === 'new_session') {
             const control = readControl(frame.data, session.frameKey);
             if (!control || typeof control.dir !== 'string')

package/dist/browse.js

@@ -4,7 +4,69 @@ import path from 'node:path';
 // 폰에서 폴더를 탭해서 파고들며 고를 수 있게, 요청받은 경로의 "하위 폴더 목록"만 돌려준다.
 // 파일 이름은 보내지 않음 — 세션을 열 위치를 고르는 용도이고, 목록이 길어질 이유도 없음.
 const MAX_ENTRIES = 300;
-export function listDirs(dir) {
+// 폴더 안의 항목 하나를 가리키는 안전한 경로를 만든다.
+// 이름에 `/` 나 `..` 이 섞여 들어오면 폴더 밖을 건드릴 수 있으므로 여기서 전부 막는다
+// (폰에서 오는 값이라 반드시 이 컴퓨터 쪽에서 검사해야 한다).
+function childPath(dir, name) {
+    if (!name || name === '.' || name === '..')
+        return null;
+    if (name.includes('/') || name.includes('\\'))
+        return null;
+    const parent = path.resolve(dir);
+    const target = path.resolve(parent, name);
+    if (path.dirname(target) !== parent)
+        return null;
+    return target;
+}
+// 이름 바꾸기 — 같은 폴더 안에서만, 이미 있는 이름으로는 덮어쓰지 않는다
+export function renameEntry(dir, name, to) {
+    const from = childPath(dir, name);
+    const dest = childPath(dir, to);
+    if (!from || !dest)
+        return { error: '이름에 쓸 수 없는 글자가 있어요.' };
+    if (from === dest)
+        return {};
+    if (fs.existsSync(dest))
+        return { error: `"${to}" 는 이미 있어요.` };
+    try {
+        fs.renameSync(from, dest);
+        return {};
+    }
+    catch (err) {
+        return { error: `이름을 바꾸지 못했어요: ${err.message}` };
+    }
+}
+// 지우기 — 파일은 바로, 폴더는 **비어 있을 때만**.
+// 폰에서 한 번 잘못 누르면 되돌릴 수 없으므로, 안에 든 것까지 통째로 지우는 일은 하지 않는다
+// (정말 필요하면 터미널에서 직접 지우면 된다).
+export function deleteEntry(dir, name) {
+    const target = childPath(dir, name);
+    if (!target)
+        return { error: '지울 수 없는 이름이에요.' };
+    let stat;
+    try {
+        stat = fs.lstatSync(target);
+    }
+    catch {
+        return { error: '이미 없어요.' };
+    }
+    try {
+        if (stat.isDirectory()) {
+            const inside = fs.readdirSync(target);
+            if (inside.length > 0) {
+                return { error: `"${name}" 안에 ${inside.length}개가 들어 있어서 여기서는 못 지워요.` };
+            }
+            fs.rmdirSync(target);
+            return {};
+        }
+        fs.unlinkSync(target);
+        return {};
+    }
+    catch (err) {
+        return { error: `지우지 못했어요: ${err.message}` };
+    }
+}
+export function listDirs(dir, opts = {}) {
     const target = path.resolve(dir);
     const up = path.dirname(target);
     const base = {
@@ -23,8 +85,9 @@ export function listDirs(dir) {
     }
     const names = items
         .filter((entry) => {
-        // 숨김 폴더(.git, .cache 등)는 제외 — 목록이 길어지고 세션을 열 곳도 아님
-        if (entry.name.startsWith('.'))
+        // 숨김 폴더(.git, .cache 등)는 기본적으로 감춘다 — 목록이 길어지기 때문.
+        // 폰에서 「숨김 보기」를 켜면 그때만 함께 보여준다.
+        if (!opts.hidden && entry.name.startsWith('.'))
             return false;
         if (entry.isDirectory())
             return true;
@@ -43,7 +106,7 @@ export function listDirs(dir) {
         .sort((a, b) => a.localeCompare(b));
     // 파일은 이름과 크기만 — 열어볼 수 있는지 폰에서 미리 판단할 수 있게 한다
     const files = items
-        .filter((entry) => !entry.name.startsWith('.') && entry.isFile())
+        .filter((entry) => (opts.hidden || !entry.name.startsWith('.')) && entry.isFile())
         .map((entry) => {
         try {
             return { name: entry.name, size: fs.statSync(path.join(target, entry.name)).size };

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/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.10.0",
+  "version": "0.12.0",
   "description": "내 컴퓨터 터미널(특히 Claude Code 세션)을 폰 브라우저로 실시간 접속하게 해주는 데스크톱 에이전트",
   "type": "module",
   "bin": {