@tienne/gestalt 0.107.0 → 0.109.0

package/dist/src/peer/locate.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Claude Code 대화 기록 위치 찾기.
+ *
+ * `sessions/<pid>.json`과 `projects/<슬러그>/<sessionId>.jsonl` 둘 다 문서화되지 않은
+ * 형식이다. 그래서 형식이 예상과 다르면 던지지 않고 이유를 담아 돌려준다 — 부르는 쪽이
+ * "어디서 무엇을 찾다 못 찾았는지"를 사람에게 그대로 보여줄 수 있어야 한다.
+ */
+export type LocateResult = {
+    ok: true;
+    path: string;
+    sessionId: string;
+    configDir: string;
+    cwd?: string;
+} | {
+    ok: false;
+    reason: string;
+    configDir: string;
+    sessionId?: string;
+};
+export interface SessionRecord {
+    sessionId: string;
+    cwd: string;
+    pid?: number;
+}
+/** 설정 디렉토리. Orca 프로필처럼 `CLAUDE_CONFIG_DIR`로 옮겨 둔 경우가 있다 */
+export declare function claudeConfigDir(env?: NodeJS.ProcessEnv): string;
+/**
+ * cwd를 `projects/` 아래 디렉토리 이름으로 바꾼다. 실제 이름을 보면 영숫자와 `-`
+ * 말고는 전부 `-`가 된다(`/Users/a/.x` → `-Users-a--x`, 한글도 `-`).
+ */
+export declare function cwdSlug(cwd: string): string;
+export declare function isSessionId(value: string): boolean;
+/** `sessions/<pid>.json` 하나를 읽는다. 형식이 다르면 null */
+export declare function readSessionFile(path: string): SessionRecord | null;
+/** 부모 pid로 세션을 찾는다. MCP 서버처럼 세션의 자식이 쓴다 */
+export declare function findSessionByPid(pid: number, configDir?: string): SessionRecord | null;
+/**
+ * sessionId로 대화 기록 경로를 찾는다.
+ *
+ * 1. `sessions/*.json`에서 그 세션의 cwd를 찾아 슬러그 경로를 본다
+ * 2. 없으면(세션이 끝났거나 슬러그 규칙이 다르면) `projects/*` 아래를 훑는다
+ */
+export declare function locateTranscript(sessionId: string, configDir?: string): LocateResult;
+//# sourceMappingURL=locate.d.ts.map

package/dist/src/peer/locate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.d.ts","sourceRoot":"","sources":["../../../src/peer/locate.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAI5E;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAKD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAclE;AAED,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAoB,GAAG,aAAa,GAAG,IAAI,CAGjG;AA0BD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,SAAoB,GAAG,YAAY,CAoC/F"}

package/dist/src/peer/locate.js

@@ -0,0 +1,116 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { isAbsolute, join } from 'node:path';
+/** 설정 디렉토리. Orca 프로필처럼 `CLAUDE_CONFIG_DIR`로 옮겨 둔 경우가 있다 */
+export function claudeConfigDir(env = process.env) {
+    const raw = env['CLAUDE_CONFIG_DIR'];
+    if (raw && isAbsolute(raw))
+        return raw;
+    return join(homedir(), '.claude');
+}
+/**
+ * cwd를 `projects/` 아래 디렉토리 이름으로 바꾼다. 실제 이름을 보면 영숫자와 `-`
+ * 말고는 전부 `-`가 된다(`/Users/a/.x` → `-Users-a--x`, 한글도 `-`).
+ */
+export function cwdSlug(cwd) {
+    return cwd.replace(/[^A-Za-z0-9-]/g, '-');
+}
+/** sessionId가 경로 조각으로 쓰이므로 `..`이나 `/`가 들어오면 안 된다 */
+const SESSION_ID = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/;
+export function isSessionId(value) {
+    return SESSION_ID.test(value);
+}
+/** `sessions/<pid>.json` 하나를 읽는다. 형식이 다르면 null */
+export function readSessionFile(path) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const rec = parsed;
+    const sessionId = rec['sessionId'];
+    const cwd = rec['cwd'];
+    if (typeof sessionId !== 'string' || typeof cwd !== 'string')
+        return null;
+    const pid = typeof rec['pid'] === 'number' ? rec['pid'] : undefined;
+    return { sessionId, cwd, pid };
+}
+/** 부모 pid로 세션을 찾는다. MCP 서버처럼 세션의 자식이 쓴다 */
+export function findSessionByPid(pid, configDir = claudeConfigDir()) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return null;
+    return readSessionFile(join(configDir, 'sessions', `${pid}.json`));
+}
+function findSessionById(sessionId, configDir) {
+    const dir = join(configDir, 'sessions');
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return null;
+    }
+    for (const name of names) {
+        if (!/^\d+\.json$/.test(name))
+            continue;
+        const rec = readSessionFile(join(dir, name));
+        if (rec?.sessionId === sessionId)
+            return rec;
+    }
+    return null;
+}
+function isFile(path) {
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * sessionId로 대화 기록 경로를 찾는다.
+ *
+ * 1. `sessions/*.json`에서 그 세션의 cwd를 찾아 슬러그 경로를 본다
+ * 2. 없으면(세션이 끝났거나 슬러그 규칙이 다르면) `projects/*` 아래를 훑는다
+ */
+export function locateTranscript(sessionId, configDir = claudeConfigDir()) {
+    if (!isSessionId(sessionId)) {
+        return { ok: false, reason: 'sessionId 형식이 아니에요', configDir };
+    }
+    if (!existsSync(configDir)) {
+        return { ok: false, reason: '설정 디렉토리가 없어요', configDir, sessionId };
+    }
+    const session = findSessionById(sessionId, configDir);
+    if (session) {
+        const bySlug = join(configDir, 'projects', cwdSlug(session.cwd), `${sessionId}.jsonl`);
+        if (isFile(bySlug))
+            return { ok: true, path: bySlug, sessionId, configDir, cwd: session.cwd };
+    }
+    const projects = join(configDir, 'projects');
+    let dirs;
+    try {
+        dirs = readdirSync(projects);
+    }
+    catch {
+        return { ok: false, reason: 'projects 디렉토리를 못 읽었어요', configDir, sessionId };
+    }
+    for (const dir of dirs) {
+        const candidate = join(projects, dir, `${sessionId}.jsonl`);
+        if (isFile(candidate)) {
+            return { ok: true, path: candidate, sessionId, configDir, cwd: session?.cwd };
+        }
+    }
+    return {
+        ok: false,
+        reason: session
+            ? '세션은 있는데 대화 기록 파일을 못 찾았어요'
+            : '그 sessionId의 세션도 대화 기록도 못 찾았어요',
+        configDir,
+        sessionId,
+    };
+}
+//# sourceMappingURL=locate.js.map

package/dist/src/peer/locate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.js","sourceRoot":"","sources":["../../../src/peer/locate.ts"],"names":[],"mappings":"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"}

package/dist/src/peer/paths.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 데몬이 소켓과 상태 DB를 두는 자리. 기본은 `~/.gestalt/peer`이고 테스트는
+ * `GESTALT_PEER_HOME`으로 옮긴다.
+ *
+ * 상대경로는 받지 않고 던진다. `GESTALT_HOME`처럼 진짜 홈으로 돌아가면 테스트가
+ * 실수로 사용자의 데몬 소켓에 붙거나 사용자 DB에 쓴다.
+ */
+export declare function peerRoot(env?: NodeJS.ProcessEnv): string;
+export declare function socketPath(root: string): string;
+export declare function statePath(root: string): string;
+/**
+ * 같은 OS 사용자만 들어오게 디렉토리를 0700으로 만든다. 이미 있으면 권한을 다시
+ * 좁힌다 — 소켓은 listen과 chmod 사이에 잠깐 기본 권한으로 열려 있어서 그 틈을
+ * 막는 건 디렉토리다.
+ *
+ * 루트가 심링크거나 남의 것이면 거부한다. mkdir과 chmod는 심링크를 따라가서 남이 걸어
+ * 둔 링크 끝의 디렉토리에 소켓과 DB를 만들고 권한까지 바꾼다. realpath로 비교하지 않는
+ * 건 macOS 임시 디렉토리가 `/var` → `/private/var` 링크 아래라 정상 경로도 걸리기 때문이다.
+ */
+export declare function ensurePrivateDir(dir: string): void;
+/** macOS 유닉스 소켓 경로 한도(sun_path 104바이트) */
+export declare const MAX_SOCKET_PATH_BYTES = 103;
+//# sourceMappingURL=paths.d.ts.map

package/dist/src/peer/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/peer/paths.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAKrE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAUlD;AAED,0CAA0C;AAC1C,eAAO,MAAM,qBAAqB,MAAM,CAAC"}

package/dist/src/peer/paths.js

@@ -0,0 +1,50 @@
+import { chmodSync, lstatSync, mkdirSync } from 'node:fs';
+import { isAbsolute, join, normalize } from 'node:path';
+import { gestaltHome } from '../core/home.js';
+const PEER_HOME_ENV = 'GESTALT_PEER_HOME';
+/**
+ * 데몬이 소켓과 상태 DB를 두는 자리. 기본은 `~/.gestalt/peer`이고 테스트는
+ * `GESTALT_PEER_HOME`으로 옮긴다.
+ *
+ * 상대경로는 받지 않고 던진다. `GESTALT_HOME`처럼 진짜 홈으로 돌아가면 테스트가
+ * 실수로 사용자의 데몬 소켓에 붙거나 사용자 DB에 쓴다.
+ */
+export function peerRoot(env = process.env) {
+    const raw = env[PEER_HOME_ENV];
+    if (raw === undefined || raw === '')
+        return join(gestaltHome(), 'peer');
+    if (!isAbsolute(raw))
+        throw new Error(`${PEER_HOME_ENV}는 절대경로여야 해요: ${raw}`);
+    return normalize(raw);
+}
+export function socketPath(root) {
+    return join(root, 'peer.sock');
+}
+export function statePath(root) {
+    return join(root, 'state.db');
+}
+/**
+ * 같은 OS 사용자만 들어오게 디렉토리를 0700으로 만든다. 이미 있으면 권한을 다시
+ * 좁힌다 — 소켓은 listen과 chmod 사이에 잠깐 기본 권한으로 열려 있어서 그 틈을
+ * 막는 건 디렉토리다.
+ *
+ * 루트가 심링크거나 남의 것이면 거부한다. mkdir과 chmod는 심링크를 따라가서 남이 걸어
+ * 둔 링크 끝의 디렉토리에 소켓과 DB를 만들고 권한까지 바꾼다. realpath로 비교하지 않는
+ * 건 macOS 임시 디렉토리가 `/var` → `/private/var` 링크 아래라 정상 경로도 걸리기 때문이다.
+ */
+export function ensurePrivateDir(dir) {
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const st = lstatSync(dir);
+    if (st.isSymbolicLink())
+        throw new Error(`peer 디렉토리가 심링크예요: ${dir}`);
+    if (!st.isDirectory())
+        throw new Error(`peer 디렉토리 자리에 다른 파일이 있어요: ${dir}`);
+    const uid = process.getuid?.();
+    if (uid !== undefined && st.uid !== uid) {
+        throw new Error(`peer 디렉토리의 주인이 내가 아니에요: ${dir}`);
+    }
+    chmodSync(dir, 0o700);
+}
+/** macOS 유닉스 소켓 경로 한도(sun_path 104바이트) */
+export const MAX_SOCKET_PATH_BYTES = 103;
+//# sourceMappingURL=paths.js.map

package/dist/src/peer/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/peer/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC3D,MAAM,GAAG,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC;IAC/B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;IACxE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,aAAa,gBAAgB,GAAG,EAAE,CAAC,CAAC;IAC7E,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,cAAc,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;IAC3E,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAC/B,IAAI,GAAG,KAAK,SAAS,IAAI,EAAE,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACxB,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC"}

package/dist/src/peer/protocol.d.ts

@@ -0,0 +1,61 @@
+import type { ToolsLevel } from './redact.js';
+import type { ShareStatus } from './share.js';
+/** IPC 한 줄 요청. 줄 단위 JSON이다 */
+export type PeerRequest = {
+    op: 'ping';
+} | {
+    op: 'status';
+} | {
+    op: 'shares';
+} | {
+    op: 'share';
+    transcriptPath: string;
+    sessionId?: string;
+    tools?: ToolsLevel;
+    expiresMinutes?: number;
+} | {
+    op: 'unshare';
+    id: string;
+};
+export type PeerResponse<T = unknown> = {
+    ok: true;
+    result: T;
+} | {
+    ok: false;
+    error: string;
+};
+export interface ShareInfo {
+    id: string;
+    sessionId: string | null;
+    transcriptPath: string;
+    tools: ToolsLevel;
+    createdAt: number;
+    expiresAt: number;
+    status: ShareStatus;
+    viewers: number;
+    events: number;
+    unknownLines: number;
+    /** 바꾸다 예외가 나서 버린 줄 */
+    failedLines: number;
+    /** 한 줄 상한을 넘어 버린 줄 */
+    oversizedLines: number;
+    /** 메모리 상한에 밀려 새 뷰어에게 다시 못 보내는 앞부분 이벤트 */
+    droppedEvents: number;
+    title?: string;
+    url: string;
+}
+export interface DaemonStatus {
+    pid: number;
+    root: string;
+    viewerPort: number;
+    startedAt: number;
+    shares: number;
+    viewers: number;
+}
+/** 한 요청 줄의 한도. 소켓은 0600이지만 같은 사용자의 프로세스가 메모리를 못 불리게 둔다 */
+export declare const MAX_REQUEST_BYTES: number;
+/** 기본 만료. 설계 원문의 8시간 */
+export declare const DEFAULT_EXPIRES_MINUTES: number;
+/** 만료 상한. 공유를 사실상 영구로 열어 두지 못하게 한다 */
+export declare const MAX_EXPIRES_MINUTES: number;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/src/peer/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/peer/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GACd;IAAE,EAAE,EAAE,QAAQ,CAAA;CAAE,GAChB;IAAE,EAAE,EAAE,QAAQ,CAAA;CAAE,GAChB;IACE,EAAE,EAAE,OAAO,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACD;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/F,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,QAAY,CAAC;AAE3C,wBAAwB;AACxB,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C,sCAAsC;AACtC,eAAO,MAAM,mBAAmB,QAAc,CAAC"}

package/dist/src/peer/protocol.js

@@ -0,0 +1,7 @@
+/** 한 요청 줄의 한도. 소켓은 0600이지만 같은 사용자의 프로세스가 메모리를 못 불리게 둔다 */
+export const MAX_REQUEST_BYTES = 64 * 1024;
+/** 기본 만료. 설계 원문의 8시간 */
+export const DEFAULT_EXPIRES_MINUTES = 8 * 60;
+/** 만료 상한. 공유를 사실상 영구로 열어 두지 못하게 한다 */
+export const MAX_EXPIRES_MINUTES = 7 * 24 * 60;
+//# sourceMappingURL=protocol.js.map

package/dist/src/peer/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/peer/protocol.ts"],"names":[],"mappings":"AAiDA,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,CAAC;AAE3C,wBAAwB;AACxB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,CAAC;AAE9C,sCAAsC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC"}

package/dist/src/peer/redact.d.ts

@@ -0,0 +1,30 @@
+export declare const REDACTED = "[\uAC00\uB9BC]";
+/** `--tools summary`일 때 도구 결과를 자르는 길이 */
+export declare const TOOL_RESULT_SUMMARY_BYTES: number;
+export type ToolsLevel = 'full' | 'summary' | 'none';
+export declare const TOOLS_LEVELS: readonly ToolsLevel[];
+export declare function isToolsLevel(value: unknown): value is ToolsLevel;
+export interface RedactOptions {
+    /** `~`로 바꿀 홈 디렉토리. 테스트가 가짜 홈을 넣는다 */
+    home?: string;
+}
+export declare function redactText(text: string, options?: RedactOptions): string;
+/** 키를 `_`, `-`, `.`, camelCase 경계로 나눠 민감한 낱말이 있는지 본다 */
+export declare function isSensitiveKey(key: string): boolean;
+/**
+ * 도구 입력처럼 모양을 모르는 값을 가린다. 문자열은 패턴으로 가리고 민감한 키 아래
+ * 값은 패턴과 상관없이 가린다. `{ password: "hunter2" }`의 값은 어떤 패턴에도 안 걸린다.
+ *
+ * 민감한 키 아래가 평범한 객체면 안으로 들어가고 원시값이나 배열이면 통째로 가린다.
+ * 배열까지 들어가면 `cookies: ["sid=abc"]`의 원소가 그대로 나간다.
+ */
+export declare function redactValue(value: unknown, options?: RedactOptions): unknown;
+/**
+ * UTF-8 바이트 기준으로 앞부분만 남긴다. 반드시 가린 **뒤에** 자른다 — 먼저 자르면
+ * PEM 끝 표시가 잘려 나가거나 토큰 앞부분만 남아 패턴에 안 걸린다.
+ */
+export declare function truncateBytes(text: string, maxBytes: number): {
+    text: string;
+    truncated: boolean;
+};
+//# sourceMappingURL=redact.d.ts.map

package/dist/src/peer/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../../src/peer/redact.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,mBAAS,CAAC;AAE/B,yCAAyC;AACzC,eAAO,MAAM,yBAAyB,QAAW,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAErD,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAAgC,CAAC;AAE/E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAmID,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAkB5E;AAyCD,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASnD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAYhF;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAOtC"}

package/dist/src/peer/redact.js

@@ -0,0 +1,214 @@
+import { homedir } from 'node:os';
+export const REDACTED = '[가림]';
+/** `--tools summary`일 때 도구 결과를 자르는 길이 */
+export const TOOL_RESULT_SUMMARY_BYTES = 4 * 1024;
+export const TOOLS_LEVELS = ['full', 'summary', 'none'];
+export function isToolsLevel(value) {
+    return typeof value === 'string' && TOOLS_LEVELS.includes(value);
+}
+/**
+ * 비밀값 패턴. 순서가 의미 있다 — PEM 블록을 먼저 통째로 지워야 그 안의 줄이
+ * 다른 패턴에 반쯤 걸려 조각이 남지 않는다.
+ *
+ * 다 잡지는 못한다. 그래서 공유를 열 때와 뷰어 상단에 같은 경고를 띄운다.
+ */
+const PATTERNS = [
+    // 끝 표시가 없으면(잘린 출력) 끝까지 지운다. 본문 일부가 남는 것보다 낫다
+    /-----BEGIN [A-Z0-9 ]*PRIVATE KEY-----[\s\S]*?(?:-----END [A-Z0-9 ]*PRIVATE KEY-----|$)/g,
+    /\b(?:AKIA|ASIA|ABIA|ACCA)[0-9A-Z]{16}\b/g,
+    /\b(?:ghp|gho|ghu|ghs|ghr)_[A-Za-z0-9]{20,}\b/g,
+    /\bgithub_pat_[A-Za-z0-9_]{20,}\b/g,
+    /\bglpat-[A-Za-z0-9_-]{20,}/g,
+    /\bnpm_[A-Za-z0-9]{30,}/g,
+    /\beyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}/g,
+    /\bsk-ant-[A-Za-z0-9_-]{16,}/g,
+    /\bsk-[A-Za-z0-9_-]{20,}/g,
+    /\b[rs]k_(?:live|test)_[A-Za-z0-9]{16,}/g,
+    /\bAIza[A-Za-z0-9_-]{35}/g,
+    /\bxox[abposr]-[A-Za-z0-9-]{10,}/g,
+];
+/**
+ * `https://user:pass@host`. 누구로 붙는지는 남기고 비밀번호만 지운다. Redis 접속 문자열에
+ * 흔한 `redis://:pass@host`처럼 이름 없이 비밀번호만 둔 꼴도 잡으려고 이름 자리를 비워도 받는다.
+ */
+const URL_PASSWORD = /\b([a-z][a-z0-9+.-]{0,20}:\/\/[^\s:/@]{0,256}:)[^\s/@]{1,256}@/gi;
+/** `Authorization: Bearer xxx` 같은 헤더. 이름은 남기고 값만 지운다 */
+const BEARER = /\b(Bearer)\s+[A-Za-z0-9._~+/=-]{8,}/gi;
+/**
+ * `Basic` 뒤 base64 값. 대소문자를 가리고 값에 숫자나 `+`, `/`, `=`가 있거나 둘째 글자부터
+ * 대문자가 있어야 건다. `Basic authentication`이나 `Basic Configuration` 같은 영어 문장은
+ * 그대로 둔다. 헤더 꼴이 아닌 `{ authorization: 'Basic …' }` 같은 객체 출력은 이 패턴만 잡는다.
+ * 전부 대문자인 `BASIC`은 헤더 줄과 따옴표 안 헤더 패턴에만 맡긴다. 여기서 받으면 `BASIC SETTINGS` 같은 대문자
+ * 제목이 가려진다.
+ *
+ * 값은 base64 글자로만 되고 끝의 `=` 채움까지 쳐서 길이가 4의 배수인 8자 이상이어야 한다.
+ * 그래야 `Basic README.md`나 `Basic 2024-10-28` 같은 낱말이 값으로 안 읽힌다. 값 뒤에
+ * 마침표가 와도 그 뒤에 글자가 오면 값으로 안 본다. 문장 끝 마침표 앞의 값은 가리고
+ * `Ubuntu22.04` 같은 낱말은 남긴다.
+ */
+const BASIC = /\b(Basic)[ \t]+(?=[A-Za-z0-9+/]*?[0-9+/=]|[A-Za-z0-9+/][a-z0-9+/]*?[A-Z])(?:(?:[A-Za-z0-9+/]{4})+(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)|(?:[A-Za-z0-9+/]{4}){2,})(?![A-Za-z0-9+/=_~-]|\.[A-Za-z0-9])/g;
+/**
+ * 헤더 이름. token과 secret은 앞에 하이픈으로 이어진 조각이 있을 때만 받는다. 그래야
+ * `X-Auth-Token`과 `PRIVATE-TOKEN`은 걸리고 코드의 `token: string;`이나 `max_tokens: 100`은
+ * 줄 끝까지 가려지지 않는다.
+ */
+const HEADER_NAME = '(?:set-cookie|cookie|(?:[a-z0-9]+-)*api-key|(?:[a-z0-9]+-)+(?:token|secret)|(?:proxy-)?authorization)';
+/**
+ * `curl -v`가 찍는 `> Cookie: …`나 `< X-Auth-Token: …` 줄. 값에 정해진 꼴이 없어서 콜론 뒤를
+ * 줄 끝까지 가린다. `Bearer`나 `Basic`은 머리에 넣어 BEARER와 BASIC이 남긴 `Bearer [가림]`과
+ * `Basic [가림]`을 그대로 둔다.
+ */
+const HEADER_LINE = new RegExp(String.raw `^([ \t]*(?:[<>][ \t]*)?${HEADER_NAME}[ \t]*:[ \t]*(?:(?:Bearer|Basic)[ \t]+)?)[^\n]+`, 'gim');
+/**
+ * `curl -H "X-Api-Key: …" https://…`처럼 따옴표 안에 든 헤더. 줄 끝까지 가리면 뒤 URL과
+ * 옵션까지 사라지므로 닫는 따옴표 앞에서 멈춘다.
+ */
+const HEADER_QUOTED = new RegExp(String.raw `(["'])([ \t]*${HEADER_NAME}[ \t]*:[ \t]*(?:(?:Bearer|Basic)[ \t]+)?)[^"'\n]+`, 'gi');
+/**
+ * `API_KEY=…`, `export GH_TOKEN=…`처럼 이름에 KEY, TOKEN, SECRET, PASSWORD, PASSWD, PASS,
+ * PWD, COOKIE, CREDENTIAL(S), AUTH가 든 대입. 이름은 남겨야 무엇이 가려졌는지 읽힌다. `=` 앞
+ * 공백은 안 받는다. 코드의 `key = value`까지 걸면 도구 출력이 거의 다 가려진다.
+ *
+ * PASS와 AUTH는 앞뒤가 글자가 아닐 때만 받는다. 안 그러면 `BYPASS=1`, `--bypass=true`,
+ * `OAUTH_CLIENT_ID=…`, `AUTHOR=…`가 걸린다. PWD는 `_PWD`만 받는다. 셸이 찍는 `PWD=`와
+ * `OLDPWD=`는 비밀이 아니라 작업 경로다.
+ *
+ * 매치는 이름 속 KEY 같은 낱말에서 시작한다. 그 앞의 이름 조각은 매치 밖이라 그대로
+ * 남는다. 이름 앞부분까지 정규식에 넣으면 `a.a.a.…`나 `KEYKEY…` 같은 입력에서 시작점마다
+ * 앞뒤 조합을 다 훑느라 역추적이 터진다. 낱말 뒤 조각은 64자까지 미리보기로 한 번에
+ * 잡고 되돌아가지 않는다(`(?=(…))\2`).
+ *
+ * 값은 닫힌 따옴표, 따옴표 안 줄바꿈(닫는 따옴표를 4096자 안에서 찾는다), JSON 문자열
+ * 안에 이스케이프된 따옴표, 못 닫힌 따옴표(줄 끝까지), 맨 값 순서로 본다.
+ *
+ * 이스케이프된 따옴표 값은 백슬래시 개수로 갈라 읽는다. 한 번 더 감싸인 글자에서 값 안의
+ * 따옴표는 백슬래시 셋과 따옴표가 되고 값 끝 백슬래시는 닫는 따옴표 앞에 백슬래시 넷을
+ * 더 붙인다. 이 둘을 닫는 따옴표로 잘못 읽으면 뒷부분이 그대로 나가거나 다음 따옴표까지
+ * 넘어가 이웃 값이 새므로 넷, 셋과 따옴표, 둘, 하나를 서로 겹치지 않게 나눈다.
+ */
+const ASSIGNMENT = /((?:KEY|TOKEN|SECRET|PASSWORD|PASSWD|(?<![a-z])PASS(?![a-z])|_PWD(?![a-z])|COOKIE|CREDENTIALS?|(?<![a-z])AUTH(?![a-z]))(?=([A-Za-z0-9_.-]{0,64}))\2)=(?:"(?:[^"\\]|\\[\s\S]){0,4096}"|'[^']{0,4096}'|\\"(?:[^"\\\n]|\\[^"\\\n]|\\\\\\\\|\\\\\\"|\\\\[^"\\\n]){0,4096}\\"|\\?["'][^\n]*|[^\s"'\\]+)/gi;
+/**
+ * JSON이나 YAML 꼴 `"api_key": "…"`. 큰따옴표 친 키만 본다. 대화 기록 안에서 JSON이
+ * 문자열로 한 번 더 감싸이면 `\"api_key\": \"…\"`가 되므로 이스케이프된 따옴표도 받는다.
+ * 감싼 값은 ASSIGNMENT와 같이 백슬래시 개수로 갈라 읽는다.
+ *
+ * 값 안에 `\n`으로 이스케이프하지 않은 줄바꿈이 나오면 닫는 따옴표를 찾지 않고 그 줄 끝까지만
+ * 가린다. JSON 문자열에는 이스케이프하지 않은 줄바꿈이 못 들어가므로 이건 따옴표가 안 닫힌
+ * 값이다. 다음 줄까지 넘어가 닫는 따옴표를 찾으면 그 줄에 있던 다른 민감한 키를 건너뛰어 그
+ * 값이 샌다.
+ *
+ * 낱말 목록은 isSensitiveKey와 따로 간다. 여기는 키 이름의 부분 문자열로 맞추므로
+ * `auth`는 뒤가, `pass`는 앞뒤가 글자가 아닐 때만 받는다. 안 그러면 `"author"`와
+ * `"passed"`, `"bypass"`가 걸린다.
+ */
+const SENSITIVE_FIELD_WORD = '(?:key|token|secret|password|passwd|passphrase|(?<![a-z])pass(?![a-z])|pwd|cookie|credential|authorization|auth(?![a-z]))';
+const QUOTED_FIELD = new RegExp(String.raw `(\\?"[A-Za-z0-9_.-]{0,64}${SENSITIVE_FIELD_WORD}[A-Za-z0-9_.-]{0,64}\\?"\s*:\s*)(?:"(?:[^"\\\n]|\\.){0,4096}"|\\"(?:[^"\\\n]|\\[^"\\\n]|\\\\\\\\|\\\\\\"|\\\\[^"\\\n]){0,4096}\\"|\\?"[^\n]*)`, 'gi');
+/**
+ * Python이 찍는 `{'Cookie': 'sid=…'}`처럼 작은따옴표 친 키. QUOTED_FIELD와 같은 낱말을 쓴다.
+ * 값은 같은 줄에서 4096자 안에 닫는 작은따옴표가 있어야 가린다.
+ */
+const SINGLE_QUOTED_FIELD = new RegExp(String.raw `('[A-Za-z0-9_.-]{0,64}${SENSITIVE_FIELD_WORD}[A-Za-z0-9_.-]{0,64}'\s*:\s*)'(?:[^'\\\n]|\\.){0,4096}'`, 'gi');
+export function redactText(text, options = {}) {
+    let out = text;
+    for (const pattern of PATTERNS)
+        out = out.replace(pattern, REDACTED);
+    out = out.replace(URL_PASSWORD, (_m, head) => `${head}${REDACTED}@`);
+    out = out.replace(BEARER, (_m, scheme) => `${scheme} ${REDACTED}`);
+    out = out.replace(BASIC, (_m, scheme) => `${scheme} ${REDACTED}`);
+    out = out.replace(HEADER_LINE, (_m, head) => `${head}${REDACTED}`);
+    out = out.replace(HEADER_QUOTED, (_m, quote, head) => `${quote}${head}${REDACTED}`);
+    out = out.replace(ASSIGNMENT, (_m, name) => `${name}=${REDACTED}`);
+    out = out.replace(QUOTED_FIELD, (_m, head) => {
+        const q = head.startsWith('\\') ? '\\"' : '"';
+        return `${head}${q}${REDACTED}${q}`;
+    });
+    out = out.replace(SINGLE_QUOTED_FIELD, (_m, head) => `${head}'${REDACTED}'`);
+    return replaceHome(out, options.home ?? homedir());
+}
+function replaceHome(text, home) {
+    const trimmed = home.replace(/\/+$/, '');
+    // `/`나 빈 홈이면 모든 경로가 `~`로 바뀌어 읽을 수 없게 된다
+    if (trimmed.length < 2)
+        return text;
+    const escaped = trimmed.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    // `/Users/alice`가 `/Users/alice2`까지 먹지 않게 뒤를 경로 경계로 묶는다
+    return text.replace(new RegExp(`${escaped}(?=[/\\s"'\`:;,)\\]}]|$)`, 'g'), '~');
+}
+/**
+ * 이름만 봐도 값이 비밀인 키. 낱말 단위로 맞춘다. `keyword`나 `author`처럼 낱말 일부만
+ * 겹치는 키는 안 건드린다.
+ *
+ * 소문자로 붙여 쓴 `accesstoken`이나 `privatekey` 같은 낱말은 SENSITIVE_KEY_SUFFIX로 낱말
+ * 끝을 본다. `key`와 `pass`는 낱말 끝만 보면 `monkey`나 `bypass`가 걸린다. 그래서 `pass`는
+ * 낱말이 똑같을 때만 걸고 `key`는 access, secret, private, signing, encryption, master, api가
+ * 바로 앞에 붙은 합성어만 받는다. token은 복수형을 안 받는다. `max_tokens`나
+ * `input_tokens`가 흔한 도구 입력 키다.
+ */
+const SENSITIVE_KEY_WORDS = new Set([
+    'key',
+    'apikey',
+    'token',
+    'secret',
+    'password',
+    'passwd',
+    'pass',
+    'pwd',
+    'auth',
+    'authorization',
+    'credential',
+    'credentials',
+    'cookie',
+    'cookies',
+]);
+const SENSITIVE_KEY_SUFFIX = /(?:token|(?:secret|password|passwd|passphrase)s?|(?:access|secret|private|signing|encryption|master|api)keys?)$/;
+/** 키를 `_`, `-`, `.`, camelCase 경계로 나눠 민감한 낱말이 있는지 본다 */
+export function isSensitiveKey(key) {
+    const words = key
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+        .split(/[\s_.-]+/);
+    return words.some((w) => {
+        const lower = w.toLowerCase();
+        return SENSITIVE_KEY_WORDS.has(lower) || SENSITIVE_KEY_SUFFIX.test(lower);
+    });
+}
+/**
+ * 도구 입력처럼 모양을 모르는 값을 가린다. 문자열은 패턴으로 가리고 민감한 키 아래
+ * 값은 패턴과 상관없이 가린다. `{ password: "hunter2" }`의 값은 어떤 패턴에도 안 걸린다.
+ *
+ * 민감한 키 아래가 평범한 객체면 안으로 들어가고 원시값이나 배열이면 통째로 가린다.
+ * 배열까지 들어가면 `cookies: ["sid=abc"]`의 원소가 그대로 나간다.
+ */
+export function redactValue(value, options = {}) {
+    if (typeof value === 'string')
+        return redactText(value, options);
+    if (Array.isArray(value))
+        return value.map((v) => redactValue(v, options));
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            const hide = isSensitiveKey(k) && !isPlainObject(v);
+            out[redactText(k, options)] = hide ? REDACTED : redactValue(v, options);
+        }
+        return out;
+    }
+    return value;
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * UTF-8 바이트 기준으로 앞부분만 남긴다. 반드시 가린 **뒤에** 자른다 — 먼저 자르면
+ * PEM 끝 표시가 잘려 나가거나 토큰 앞부분만 남아 패턴에 안 걸린다.
+ */
+export function truncateBytes(text, maxBytes) {
+    const buf = Buffer.from(text, 'utf8');
+    if (buf.length <= maxBytes)
+        return { text, truncated: false };
+    // 멀티바이트 글자 중간에서 끊기면 깨진 글자가 남는다. 이어지는 바이트(10xxxxxx)를 건너뛴다
+    let end = maxBytes;
+    while (end > 0 && ((buf[end] ?? 0) & 0xc0) === 0x80)
+        end--;
+    return { text: buf.subarray(0, end).toString('utf8'), truncated: true };
+}
+//# sourceMappingURL=redact.js.map

package/dist/src/peer/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../../src/peer/redact.ts"],"names":[],"mappings":"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"}