shellbase 0.3.2 → 0.5.0

package/dist/agent.js

@@ -7,10 +7,11 @@ import { requireClient } from './auth.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, listOnlineDirs } from './devices.js';
+import { registerDevice, heartbeatDevice, unregisterDevice, listOnlineDirs, renameDevice, } 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 { loadOpenSessions, saveOpenSessions } from './open-sessions.js';
 const HEARTBEAT_MS = 20_000;
 const APPROVAL_TIMEOUT_MS = 30_000;
@@ -25,6 +26,8 @@ const SEND_PENALTY_MS = 500;
 const PENALTY_INTERVAL_MS = 250;
 // 실수나 버그로 세션이 무한정 늘어나는 것을 막는 상한 (한 컴퓨터에서 이 이상 필요한 경우는 사실상 없음)
 const MAX_SESSIONS = 20;
+// 저장 중인 파일 조각을 모아두는 시간 — 중간에 폰이 끊기면 조용히 버린다
+const WRITE_BUFFER_TTL_MS = 60_000;
 // 폰의 폴더 탐색기를 열 때 "지금 셸이 있는 폴더"에서 시작하려면, 세션을 시작한 폴더가 아니라
 // 셸 프로세스의 실제 작업 폴더를 봐야 한다(사용자가 cd 로 옮겨 다니므로). 리눅스는 /proc 로 바로 알 수 있고,
 // 없는 OS(맥·윈도)에서는 세션 시작 폴더로 되돌아간다.
@@ -41,9 +44,6 @@ 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;
@@ -75,6 +75,8 @@ export async function runAgent(options) {
     const hostLabel = options.name ?? os.hostname();
     const shell = resolveShell();
     const sessions = new Map();
+    // 폰에서 저장 중인 파일 조각 모음 (경로별)
+    const writeBuffers = new Map();
     function defaultName(cwd) {
         return cwd === os.homedir() ? hostLabel : `${hostLabel} · ${path.basename(cwd)}`;
     }
@@ -315,6 +317,98 @@ export async function runAgent(options) {
             void closeSession(session, { deliberate: true });
             return;
         }
+        // 폰에서 세션 이름 바꾸기 — 컴퓨터를 가리키는 앞부분은 유지해서 목록의 컴퓨터 묶음이 깨지지 않게 한다
+        if (frame.kind === 'rename') {
+            const control = readControl(frame.data, session.frameKey);
+            if (!control || typeof control.name !== 'string')
+                return;
+            const label = control.name.trim().slice(0, 40);
+            if (!label)
+                return;
+            const nextName = `${hostLabel} · ${label}`;
+            const before = session.name;
+            session.name = nextName;
+            renameDevice(cb, session.rowId, nextName)
+                .then(() => {
+                // 재시작 복구 목록에도 바뀐 이름이 남도록 저장
+                persistOpenSessions();
+                console.log(`📱 세션 이름을 바꿨어요: "${before}" → "${nextName}"`);
+            })
+                .catch((err) => {
+                session.name = before;
+                console.error('이름 변경 실패:', err.message);
+            });
+            return;
+        }
+        // 폰에서 파일 열기 — 실시간 프레임 크기 제한(20KB 남짓) 때문에 조각으로 나눠 보낸다
+        if (frame.kind === 'read_file') {
+            const control = readControl(frame.data, session.frameKey);
+            if (!control || typeof control.path !== 'string')
+                return;
+            const filePath = control.path;
+            const result = readTextFile(filePath);
+            if (!result.ok) {
+                void send({
+                    kind: 'file_error',
+                    to: session.deviceId,
+                    data: encryptFrame(JSON.stringify({ path: filePath, reason: result.reason }), session.frameKey),
+                });
+                return;
+            }
+            const chunks = chunkContent(result.content);
+            void (async () => {
+                for (let index = 0; index < chunks.length; index++) {
+                    await send({
+                        kind: 'file_chunk',
+                        to: session.deviceId,
+                        data: encryptFrame(JSON.stringify({ path: filePath, index, total: chunks.length, chunk: chunks[index] }), session.frameKey),
+                    });
+                }
+            })();
+            return;
+        }
+        // 폰에서 파일 저장 — 조각이 다 모이면 임시 파일에 쓴 뒤 교체한다 (files.ts)
+        if (frame.kind === 'write_file') {
+            const control = readControl(frame.data, session.frameKey);
+            if (!control ||
+                typeof control.path !== 'string' ||
+                typeof control.chunk !== 'string' ||
+                typeof control.index !== 'number' ||
+                typeof control.total !== 'number') {
+                return;
+            }
+            const key = `${session.deviceId}:${control.path}`;
+            const now = Date.now();
+            for (const [bufferKey, buffer] of writeBuffers) {
+                if (now - buffer.at > WRITE_BUFFER_TTL_MS)
+                    writeBuffers.delete(bufferKey);
+            }
+            const buffer = control.index === 0
+                ? { parts: [], total: control.total, at: now }
+                : (writeBuffers.get(key) ?? { parts: [], total: control.total, at: now });
+            buffer.parts[control.index] = control.chunk;
+            buffer.at = now;
+            writeBuffers.set(key, buffer);
+            if (buffer.parts.filter((part) => typeof part === 'string').length < buffer.total)
+                return;
+            writeBuffers.delete(key);
+            const filePath = control.path;
+            const result = writeTextFile(filePath, buffer.parts.join(''));
+            void send(result.ok
+                ? {
+                    kind: 'file_saved',
+                    to: session.deviceId,
+                    data: encryptFrame(JSON.stringify({ path: filePath }), session.frameKey),
+                }
+                : {
+                    kind: 'file_error',
+                    to: session.deviceId,
+                    data: encryptFrame(JSON.stringify({ path: filePath, reason: result.reason }), session.frameKey),
+                });
+            if (result.ok)
+                console.log(`📱 폰에서 파일을 저장했어요: ${filePath}`);
+            return;
+        }
         if (frame.kind === 'list_dirs') {
             const control = readControl(frame.data, session.frameKey);
             if (!control)

package/dist/browse.js

@@ -12,6 +12,7 @@ export function listDirs(dir) {
         parent: up === target ? null : up,
         home: os.homedir(),
         entries: [],
+        files: [],
     };
     let items;
     try {
@@ -40,9 +41,22 @@ export function listDirs(dir) {
     })
         .map((entry) => entry.name)
         .sort((a, b) => a.localeCompare(b));
+    // 파일은 이름과 크기만 — 열어볼 수 있는지 폰에서 미리 판단할 수 있게 한다
+    const files = items
+        .filter((entry) => !entry.name.startsWith('.') && entry.isFile())
+        .map((entry) => {
+        try {
+            return { name: entry.name, size: fs.statSync(path.join(target, entry.name)).size };
+        }
+        catch {
+            return { name: entry.name, size: 0 };
+        }
+    })
+        .sort((a, b) => a.name.localeCompare(b.name));
     return {
         ...base,
         entries: names.slice(0, MAX_ENTRIES),
-        truncated: names.length > MAX_ENTRIES,
+        files: files.slice(0, MAX_ENTRIES),
+        truncated: names.length > MAX_ENTRIES || files.length > MAX_ENTRIES,
     };
 }

package/dist/devices.js

@@ -46,3 +46,7 @@ export async function listOnlineDirs(cb) {
     }
     return dirs;
 }
+// 폰에서 세션 이름을 바꿀 때 — 목록 row 의 표시 이름만 갱신한다 (세션 자체는 그대로 유지)
+export async function renameDevice(cb, rowId, deviceName) {
+    await cb.database.updateData(DEVICES_TABLE_ID, rowId, { data: { device_name: deviceName } });
+}

package/dist/files.js

@@ -0,0 +1,69 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+// 폰에서 파일을 열어보고 고칠 수 있게 하는 읽기/쓰기. 실시간 프레임은 한 번에 20KB 남짓만 보낼 수 있어서
+// (실측: 16KB 성공 / 64KB 거부) 파일은 조각으로 나눠 주고받는다.
+export const CHUNK_SIZE = 12 * 1024;
+export const MAX_FILE_SIZE = 512 * 1024;
+function expand(target) {
+    if (target.startsWith('~'))
+        return path.join(os.homedir(), target.slice(1));
+    return path.resolve(target);
+}
+export function readTextFile(target) {
+    const full = expand(target);
+    let stat;
+    try {
+        stat = fs.statSync(full);
+    }
+    catch {
+        return { ok: false, reason: `파일을 찾을 수 없어요: ${full}` };
+    }
+    if (stat.isDirectory())
+        return { ok: false, reason: '폴더는 열 수 없어요.' };
+    if (stat.size > MAX_FILE_SIZE) {
+        return {
+            ok: false,
+            reason: `파일이 너무 커요 (${Math.round(stat.size / 1024)}KB) — ${MAX_FILE_SIZE / 1024}KB 까지만 열 수 있어요.`,
+        };
+    }
+    let buffer;
+    try {
+        buffer = fs.readFileSync(full);
+    }
+    catch (err) {
+        return { ok: false, reason: `파일을 읽지 못했어요: ${err.message}` };
+    }
+    // 사진·실행파일 같은 이진 파일은 에디터에서 의미가 없고 깨져 보이기만 하므로 미리 거른다
+    if (buffer.subarray(0, 8192).includes(0)) {
+        return { ok: false, reason: '글자 파일이 아니에요 (이진 파일은 열 수 없어요).' };
+    }
+    return { ok: true, content: buffer.toString('utf8'), size: stat.size };
+}
+export function writeTextFile(target, content) {
+    const full = expand(target);
+    try {
+        // 같은 폴더에 임시 파일로 먼저 쓰고 교체 — 저장 도중 끊겨도 원본이 깨지지 않는다
+        const tmp = path.join(path.dirname(full), `.${path.basename(full)}.shellbase-tmp`);
+        let mode;
+        try {
+            mode = fs.statSync(full).mode;
+        }
+        catch {
+            // 새 파일이면 기본 권한
+        }
+        fs.writeFileSync(tmp, content, mode === undefined ? undefined : { mode });
+        fs.renameSync(tmp, full);
+        return { ok: true };
+    }
+    catch (err) {
+        return { ok: false, reason: `저장하지 못했어요: ${err.message}` };
+    }
+}
+export function chunkContent(content) {
+    const chunks = [];
+    for (let i = 0; i < content.length; i += CHUNK_SIZE) {
+        chunks.push(content.slice(i, i + CHUNK_SIZE));
+    }
+    return chunks.length > 0 ? chunks : [''];
+}

package/package.json

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