@tienne/gestalt 0.108.0 → 0.110.0

package/dist/src/peer/transform.js

@@ -0,0 +1,237 @@
+import { redactText, redactValue, truncateBytes, TOOL_RESULT_SUMMARY_BYTES } from './redact.js';
+/** `tool_use` 입력 요약 길이. 결과보다 짧게 둔다 — 입력은 접힌 줄 제목처럼 읽힌다 */
+const TOOL_INPUT_SUMMARY_BYTES = 1024;
+/**
+ * 내용을 안 보내는 줄 종류. 2.1.311 기록에서 본 것들이다. 여기 있는 건 조용히
+ * 버리고 여기에도 허용 목록에도 없는 종류만 "모르는 줄"로 센다.
+ *
+ * 이 목록은 차단 목록이 아니다. 지워도 새는 게 없고 "모르는 줄" 숫자만 는다.
+ */
+const KNOWN_DROPPED = new Set([
+    'api-request',
+    'api-request-blob',
+    'api-request-shape',
+    'attachment',
+    'system',
+    'last-prompt',
+    'queue-operation',
+    'tools-used',
+    'cost-state',
+    'mode',
+    'atis-latch',
+    'summary',
+    'file-history-snapshot',
+]);
+const SYSTEM_REMINDER = /<system-reminder>[\s\S]*?(?:<\/system-reminder>|$)/g;
+/** user 텍스트에서 `<system-reminder>` 블록을 지운다. 닫는 태그가 없으면 끝까지 지운다 */
+export function stripSystemReminders(text) {
+    return text.replace(SYSTEM_REMINDER, '').trim();
+}
+/**
+ * 대화 기록 jsonl 한 줄씩 받아 허용 목록에 있는 것만 `PeerEvent`로 바꾼다.
+ *
+ * 허용 목록이다. 줄 종류든 content 블록 종류든 여기서 명시적으로 꺼내지 않은 건
+ * 아무것도 안 나간다. 형식이 바뀌어 새 필드나 새 종류가 생겨도 그대로 새지 않는다.
+ *
+ * 상태가 있다 — 서브에이전트 줄이 이어지면 표시를 한 번만 낸다.
+ */
+export class TranscriptTransformer {
+    options;
+    inSidechain = false;
+    unknown = 0;
+    failed = 0;
+    claudeVersion;
+    constructor(options) {
+        this.options = options;
+    }
+    /** 모르는 줄 종류와 JSON으로 안 읽힌 줄을 합친 수 */
+    get unknownLines() {
+        return this.unknown;
+    }
+    /**
+     * 바꾸다 예외가 난 줄 수. 모르는 줄과 따로 센다. 모르는 줄은 형식이 바뀐 신호라 감사
+     * 로그에 버전과 함께 남기는데 여기에 섞이면 그 신호가 흐려진다.
+     */
+    get failedLines() {
+        return this.failed;
+    }
+    /** 마지막으로 본 Claude Code 버전. 모르는 줄이 생겼을 때 감사 로그에 남긴다 */
+    get version() {
+        return this.claudeVersion;
+    }
+    /**
+     * 한 줄을 바꾼다. 줄 하나에서 난 예외는 여기서 접고 그 줄만 버린다. 2만 단계로
+     * 중첩된 도구 입력이 가리기 재귀에서 스택을 넘기는 걸 봤다. 던지게 두면 이 공유의
+     * 나머지 줄을 더 못 읽는다. 읽던 중이면 tick이 그 공유를 error로 종료하고 공유를 여는
+     * 첫 poll이면 share 요청이 실패한다.
+     */
+    push(line) {
+        try {
+            return this.parse(line);
+        }
+        catch {
+            this.failed++;
+            return [];
+        }
+    }
+    parse(line) {
+        const trimmed = line.trim();
+        if (trimmed === '')
+            return [];
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            this.unknown++;
+            return [];
+        }
+        if (!isRecord(parsed) || typeof parsed['type'] !== 'string') {
+            this.unknown++;
+            return [];
+        }
+        if (typeof parsed['version'] === 'string')
+            this.claudeVersion = parsed['version'];
+        const type = parsed['type'];
+        const at = typeof parsed['timestamp'] === 'string' ? parsed['timestamp'] : undefined;
+        if (type === 'ai-title') {
+            const title = parsed['aiTitle'];
+            return typeof title === 'string' && title.trim() !== ''
+                ? [{ kind: 'title', text: this.redact(title) }]
+                : [];
+        }
+        if (type !== 'user' && type !== 'assistant') {
+            if (!KNOWN_DROPPED.has(type))
+                this.unknown++;
+            return [];
+        }
+        if (parsed['isSidechain'] === true) {
+            if (this.inSidechain)
+                return [];
+            this.inSidechain = true;
+            return [{ kind: 'sidechain', at }];
+        }
+        this.inSidechain = false;
+        // 하네스가 끼워 넣은 줄이다. 주인이 친 말이 아니고 CLAUDE.md나 명령 출력이 들어 있다
+        if (parsed['isMeta'] === true)
+            return [];
+        // 압축 요약은 지난 대화 전체를 다시 적은 글이라 그 안에 무엇이 섞였는지 모른다
+        if (parsed['isCompactSummary'] === true)
+            return [{ kind: 'compacted', at }];
+        const message = parsed['message'];
+        if (!isRecord(message))
+            return [];
+        const content = message['content'];
+        return type === 'user' ? this.fromUser(content, at) : this.fromAssistant(content, at);
+    }
+    fromUser(content, at) {
+        if (typeof content === 'string')
+            return this.prompt(content, at);
+        if (!Array.isArray(content))
+            return [];
+        const events = [];
+        for (const block of content) {
+            if (!isRecord(block))
+                continue;
+            if (block['type'] === 'text' && typeof block['text'] === 'string') {
+                events.push(...this.prompt(block['text'], at));
+            }
+            else if (block['type'] === 'tool_result') {
+                events.push(this.toolResult(block, at));
+            }
+        }
+        return events;
+    }
+    fromAssistant(content, at) {
+        if (typeof content === 'string') {
+            const text = this.redact(content).trim();
+            return text === '' ? [] : [{ kind: 'reply', text, at }];
+        }
+        if (!Array.isArray(content))
+            return [];
+        const events = [];
+        for (const block of content) {
+            if (!isRecord(block))
+                continue;
+            if (block['type'] === 'text' && typeof block['text'] === 'string') {
+                const text = this.redact(block['text']).trim();
+                if (text !== '')
+                    events.push({ kind: 'reply', text, at });
+            }
+            else if (block['type'] === 'tool_use') {
+                events.push(this.toolCall(block, at));
+            }
+            // thinking, redacted_thinking, server_tool_use 등은 꺼내지 않는다
+        }
+        return events;
+    }
+    prompt(raw, at) {
+        const text = this.redact(stripSystemReminders(raw));
+        return text === '' ? [] : [{ kind: 'prompt', text, at }];
+    }
+    toolCall(block, at) {
+        const id = typeof block['id'] === 'string' ? block['id'] : '';
+        const name = typeof block['name'] === 'string' ? this.redact(block['name']) : '(이름 없음)';
+        if (this.options.tools === 'none')
+            return { kind: 'tool_call', id, name, at };
+        const redacted = redactValue(block['input'] ?? {}, this.options);
+        const json = JSON.stringify(redacted) ?? '';
+        const input = this.options.tools === 'full' ? json : truncateBytes(json, TOOL_INPUT_SUMMARY_BYTES).text;
+        return { kind: 'tool_call', id, name, input, at };
+    }
+    toolResult(block, at) {
+        const toolUseId = typeof block['tool_use_id'] === 'string' ? block['tool_use_id'] : '';
+        const isError = block['is_error'] === true;
+        if (this.options.tools === 'none') {
+            return { kind: 'tool_result', toolUseId, truncated: false, hidden: true, isError, at };
+        }
+        const full = this.redact(resultText(block['content']));
+        if (this.options.tools === 'full') {
+            return {
+                kind: 'tool_result',
+                toolUseId,
+                text: full,
+                truncated: false,
+                hidden: false,
+                isError,
+                at,
+            };
+        }
+        const cut = truncateBytes(full, TOOL_RESULT_SUMMARY_BYTES);
+        return {
+            kind: 'tool_result',
+            toolUseId,
+            text: cut.text,
+            truncated: cut.truncated,
+            hidden: false,
+            isError,
+            at,
+        };
+    }
+    redact(text) {
+        return redactText(text, this.options);
+    }
+}
+/** tool_result의 content는 문자열이거나 블록 배열이다. 텍스트 블록만 꺼낸다 */
+function resultText(content) {
+    if (typeof content === 'string')
+        return stripSystemReminders(content);
+    if (!Array.isArray(content))
+        return '';
+    const parts = [];
+    for (const block of content) {
+        if (!isRecord(block))
+            continue;
+        if (block['type'] === 'text' && typeof block['text'] === 'string') {
+            parts.push(stripSystemReminders(block['text']));
+        }
+        else if (block['type'] === 'image') {
+            parts.push('[이미지]');
+        }
+    }
+    return parts.join('\n');
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=transform.js.map

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

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

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

@@ -0,0 +1,89 @@
+import { EventEmitter } from 'node:events';
+import type { MachineKey } from './keys.js';
+import type { SignedRoster } from './roster.js';
+import type { HelloMode } from './wire.js';
+/**
+ * 데몬끼리 봉인한 바이트를 주고받는 통로. 1차 구현은 RelayTransport 하나다.
+ * 나중에 P2P 통로를 더할 때 같은 모양을 맞춘다.
+ */
+export interface PeerTransport {
+    connect(roster: SignedRoster | null): Promise<void>;
+    /** 릴레이가 받는 기기에게 넘겼으면 delivered. PR 2 릴레이는 쌓지 않아서 queued는 아직 안 나온다 */
+    send(to: string, sealed: Uint8Array): Promise<'queued' | 'delivered'>;
+    onReceive(handler: (from: string, sealed: Uint8Array) => void): void;
+    close(): Promise<void>;
+}
+export type TransportState = 'idle' | 'connecting' | 'online' | 'offline' | 'removed' | 'closed';
+export interface RelayTransportOptions {
+    url: string;
+    team: string;
+    key: MachineKey;
+    mode?: HelloMode;
+    /** 끊기면 다시 붙는다. join 모드는 기본 끔 */
+    reconnect?: boolean;
+    minBackoffMs?: number;
+    maxBackoffMs?: number;
+    ackTimeoutMs?: number;
+}
+export declare class RelaySendError extends Error {
+    readonly reason: string;
+    constructor(reason: string);
+}
+/**
+ * 릴레이 접속 하나. 이벤트:
+ * - `state`(TransportState)
+ * - `welcome`(roster, online) — member로 붙었다. 다시 붙을 때마다 온다
+ * - `roster`(SignedRoster) — 릴레이가 새 명단을 돌렸다. 받을지는 부른 쪽이 다시 확인한다
+ * - `presence`(key, online)
+ * - `join`(from, sealed) — 관리자에게 온 join 요청
+ * - `relay-error`(code, message)
+ */
+export declare class RelayTransport extends EventEmitter implements PeerTransport {
+    private readonly options;
+    private ws;
+    private roster;
+    private status;
+    private nextId;
+    private acks;
+    private resolves;
+    private receivers;
+    private backoff;
+    private retry;
+    private announced;
+    constructor(options: RelayTransportOptions);
+    get state(): TransportState;
+    get bufferedAmount(): number;
+    /** 다음 hello에 들고 갈 명단 */
+    setRoster(roster: SignedRoster | null): void;
+    /**
+     * 처음 붙는다. member면 welcome, join 모드면 pending까지 기다린다. 첫 시도가 실패하면
+     * 던지고 reconnect가 켜져 있으면 뒤에서 계속 다시 붙는다.
+     */
+    connect(roster: SignedRoster | null): Promise<void>;
+    onReceive(handler: (from: string, sealed: Uint8Array) => void): void;
+    send(to: string, sealed: Uint8Array): Promise<'queued' | 'delivered'>;
+    /**
+     * 답을 안 기다리고 보낸다. 공유 스트림 프레임처럼 자주 가는 것에 쓴다. 릴레이도 ack를
+     * 안 돌려준다. 받는 쪽이 없으면 조용히 버려진다.
+     */
+    post(to: string, sealed: Uint8Array): boolean;
+    /** 공유 id를 연 기기를 릴레이에 묻는다 */
+    resolveShare(share: string, timeoutMs?: number): Promise<string | null>;
+    /** 지금 연 공유 id 전부를 알린다. 다시 붙을 때도 같은 목록을 다시 보낸다 */
+    announce(shares: string[]): void;
+    publishRoster(roster: SignedRoster): void;
+    sendJoin(to: string, sealed: Uint8Array): boolean;
+    close(): Promise<void>;
+    private attempt;
+    private lost;
+    /**
+     * 릴레이가 보낸 프레임. 릴레이도 믿지 않는 쪽이라 꼴이 틀린 프레임은 버린다. 여기서
+     * 던지면 소켓 data 핸들러 밖으로 나가 데몬이 죽는다.
+     */
+    private onMessage;
+    private dispatch;
+    private write;
+    private failPending;
+    private setState;
+}
+//# sourceMappingURL=transport.d.ts.map

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

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