@yefengr/pi-reach 0.0.0-stage → 0.0.2

package/dist/runtime/pairing_coordinator.js

@@ -0,0 +1,136 @@
+import { V2PeerChannel } from "../transport/peer_channel.js";
+/** Coordinates one-process pairing retries across storage and Relay lifecycles. */
+export class PairingCoordinator {
+    deps;
+    attempts = new Map();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async handle(relay, ownerId, frame) {
+        if (!this.deps.isRelayCurrent(relay))
+            return;
+        const key = this.attemptKey(ownerId, frame.id);
+        const pending = this.attempts.get(key);
+        if (pending) {
+            await pending.completion;
+            return this.handle(relay, ownerId, frame);
+        }
+        const reservation = this.deps.qrSession.reserveCode(frame.code, ownerId, frame.id);
+        if (reservation.status === "expired" || reservation.status === "consumed" || reservation.status === "unknown") {
+            const code = reservation.status === "expired" ? "token_expired" : reservation.status === "consumed" ? "token_consumed" : "token_unknown";
+            this.reject(relay, ownerId, frame, code, reservation.status === "consumed" ? "Pairing code is already in use" : "Pairing code is invalid or expired");
+            return;
+        }
+        if (reservation.status === "committed") {
+            const activeBinding = this.deps.activeBinding(ownerId);
+            if (activeBinding) {
+                activeBinding.channel.sendV2(reservation.completion);
+                return;
+            }
+            const replayBinding = this.deps.attachOwner(relay, ownerId);
+            replayBinding?.channel.sendV2(reservation.completion);
+            return;
+        }
+        if (reservation.status !== "reserved")
+            return;
+        const binding = this.deps.attachOwner(relay, ownerId);
+        if (!binding) {
+            this.deps.qrSession.releaseCode(reservation.reservation);
+            return;
+        }
+        let resolveCompletion;
+        const completion = new Promise((resolve) => { resolveCompletion = resolve; });
+        const attempt = {
+            key,
+            ownerId,
+            relay,
+            binding,
+            reservation: reservation.reservation,
+            completion,
+            resolveCompletion,
+        };
+        this.attempts.set(key, attempt);
+        void this.run(attempt, frame);
+    }
+    abandonInactive() {
+        for (const attempt of [...this.attempts.values()]) {
+            if (this.lifecycleIsCurrent(attempt))
+                continue;
+            this.attempts.delete(attempt.key);
+            this.deps.qrSession.releaseCode(attempt.reservation);
+            attempt.resolveCompletion(null);
+        }
+    }
+    async run(attempt, frame) {
+        let completion = null;
+        let receipt;
+        try {
+            receipt = await this.deps.addPeer({ name: frame.device_name, remote_epk: attempt.ownerId, paired_at: new Date().toISOString() });
+            if (!this.canCommit(attempt)) {
+                await this.rollback(receipt);
+                return;
+            }
+            // peers.json is durable authority, but do not confirm pairing while the
+            // current Relay has explicitly rejected the ACL frame. A later retry of
+            // the same request can safely repeat the idempotent write.
+            const aclSent = await this.deps.updateEndpoint(attempt.relay);
+            if (!aclSent || !this.canCommit(attempt)) {
+                await this.rollback(receipt);
+                return;
+            }
+            const pairOk = this.deps.buildPairOk(frame);
+            if (!this.deps.qrSession.commitCode(attempt.reservation, pairOk)) {
+                await this.rollback(receipt);
+                return;
+            }
+            completion = pairOk;
+            attempt.binding.channel.sendV2(pairOk);
+        }
+        catch {
+            if (receipt)
+                await this.rollback(receipt);
+            if (this.lifecycleIsCurrent(attempt)) {
+                this.sendError(attempt.binding.channel, frame, "internal_error", "Failed to persist pairing");
+            }
+        }
+        finally {
+            if (!completion)
+                this.deps.qrSession.releaseCode(attempt.reservation);
+            if (this.attempts.get(attempt.key) === attempt)
+                this.attempts.delete(attempt.key);
+            attempt.resolveCompletion(completion);
+        }
+    }
+    async rollback(receipt) {
+        try {
+            await this.deps.rollbackPeer(receipt);
+        }
+        catch {
+            // A failed compensation leaves peers.json authoritative.
+        }
+        // A new Relay may have announced the transient write while this old
+        // attempt was pending. Always refresh whichever Relay is current now.
+        try {
+            await this.deps.refreshCurrentEndpoint();
+        }
+        catch { /* reconnect owns recovery */ }
+    }
+    lifecycleIsCurrent(attempt) {
+        return this.deps.isRelayCurrent(attempt.relay) && this.deps.activeBinding(attempt.ownerId) === attempt.binding;
+    }
+    canCommit(attempt) {
+        return this.lifecycleIsCurrent(attempt) && this.deps.qrSession.isReservationCurrent(attempt.reservation);
+    }
+    reject(relay, ownerId, frame, code, message) {
+        const channel = new V2PeerChannel(relay, ownerId, this.deps.routeIdentity(), () => undefined);
+        this.sendError(channel, frame, code, message);
+        channel.detach();
+    }
+    sendError(channel, frame, code, message) {
+        channel.sendV2({ protocol_version: 2, type: "pair_error", in_reply_to: frame.id, code, message });
+    }
+    attemptKey(ownerId, requestId) {
+        return `${ownerId}\u0000${requestId}`;
+    }
+}
+//# sourceMappingURL=pairing_coordinator.js.map

package/dist/runtime/pairing_coordinator.js.map

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

package/dist/runtime/relay_lifecycle.d.ts

@@ -0,0 +1,64 @@
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { RelayResolution } from "../config.js";
+import type { Ed25519Keypair } from "../pairing/crypto.js";
+import type { HostConnectOptions, RelayClient } from "../transport/relay_client.js";
+export type RemoteState = "idle" | "started";
+export type RelayConnectivity = "connected" | "reconnecting" | "disconnected";
+export type RelayDisplayStatus = "off" | "connecting" | "connected" | "reconnecting" | "failed";
+export type InitialRelayResult = "completed" | "cancelled";
+export type RelayStartContext = Pick<ExtensionContext, "ui" | "cwd">;
+export interface RelayLifecycleDependencies {
+    loadIdentity(): Promise<Ed25519Keypair>;
+    resolveRelayUrl(): RelayResolution;
+    createClient(relayUrl: string, identity: Ed25519Keypair): RelayClient;
+    buildConnectOptions(cwd?: string): Promise<HostConnectOptions>;
+    handleIdentityError(error: unknown, ctx: RelayStartContext): boolean;
+    describeConnection(resolution: RelayResolution): string;
+    onStateChange(): void;
+    onDisplayStatusChange(): void;
+    onConnected(client: RelayClient, ctx?: RelayStartContext): void;
+    onDisconnected(): void;
+}
+export declare class RelayLifecycle {
+    private readonly deps;
+    private activeRelay;
+    private pendingCandidate;
+    private currentRelayUrl;
+    private identity;
+    private initialAttempt;
+    private cancelInitialAttempt;
+    private reconnectTimer;
+    private reconnectAttempt;
+    private generation;
+    private isDisposed;
+    private currentState;
+    private currentDisplayStatus;
+    private readonly closedCandidates;
+    constructor(deps: RelayLifecycleDependencies);
+    get state(): RemoteState;
+    get relay(): RelayClient | null;
+    get relayUrl(): string | null;
+    get keypair(): Ed25519Keypair | null;
+    get disposed(): boolean;
+    get hasPendingReconnect(): boolean;
+    get status(): RelayConnectivity;
+    get displayStatus(): RelayDisplayStatus;
+    isCurrent(candidate: RelayClient): boolean;
+    setDisposed(value: boolean): void;
+    start(ctx: RelayStartContext): Promise<InitialRelayResult>;
+    waitForInitial(): Promise<InitialRelayResult>;
+    stop(): void;
+    private startInitial;
+    private scheduleReconnect;
+    private reconnect;
+    private onRelayClose;
+    private handleConnectionFailure;
+    private markInitialFailure;
+    private setDisplayStatus;
+    private clearCandidate;
+    private closeCandidateOnce;
+    private clearInitialAttempt;
+    private isOperationCurrent;
+    private isReconnectCurrent;
+    private notify;
+}

package/dist/runtime/relay_lifecycle.js

@@ -0,0 +1,275 @@
+const RECONNECT_BACKOFFS_MS = [1_000, 2_000, 5_000, 10_000, 30_000];
+export class RelayLifecycle {
+    deps;
+    activeRelay = null;
+    pendingCandidate = null;
+    currentRelayUrl = null;
+    identity = null;
+    initialAttempt = null;
+    cancelInitialAttempt = null;
+    reconnectTimer = null;
+    reconnectAttempt = 0;
+    generation = 0;
+    isDisposed = false;
+    currentState = "idle";
+    currentDisplayStatus = "off";
+    closedCandidates = new WeakSet();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    get state() { return this.currentState; }
+    get relay() { return this.activeRelay; }
+    get relayUrl() { return this.currentRelayUrl; }
+    get keypair() { return this.identity; }
+    get disposed() { return this.isDisposed; }
+    get hasPendingReconnect() { return this.reconnectTimer !== null; }
+    get status() {
+        if (this.currentState === "idle")
+            return "disconnected";
+        return this.activeRelay?.isOpen() ? "connected" : "reconnecting";
+    }
+    get displayStatus() { return this.currentDisplayStatus; }
+    isCurrent(candidate) {
+        return !this.isDisposed && this.currentState === "started" && this.activeRelay === candidate;
+    }
+    setDisposed(value) {
+        this.isDisposed = value;
+    }
+    start(ctx) {
+        const existing = this.initialAttempt;
+        if (existing)
+            return existing;
+        if (this.currentState !== "idle") {
+            const message = this.status === "reconnecting"
+                ? "[pi-reach] Relay is reconnecting in background."
+                : "[pi-reach] Already connected.";
+            this.notify(ctx, message, "warning");
+            return Promise.resolve("completed");
+        }
+        const expectedGeneration = ++this.generation;
+        this.setDisplayStatus("connecting");
+        const operation = this.startInitial(ctx, expectedGeneration).catch((error) => {
+            this.markInitialFailure(expectedGeneration);
+            throw error;
+        });
+        let cancel;
+        const cancellation = new Promise((resolve) => {
+            cancel = () => resolve("cancelled");
+        });
+        const attempt = Promise.race([operation.then(() => "completed"), cancellation]);
+        this.initialAttempt = attempt;
+        this.cancelInitialAttempt = cancel;
+        void operation.catch(() => undefined);
+        void attempt.then(() => this.clearInitialAttempt(attempt, cancel), () => this.clearInitialAttempt(attempt, cancel));
+        return attempt;
+    }
+    waitForInitial() {
+        return this.initialAttempt ?? Promise.resolve("completed");
+    }
+    stop() {
+        this.generation += 1;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.reconnectAttempt = 0;
+        const active = this.activeRelay;
+        const pending = this.pendingCandidate;
+        const cancel = this.cancelInitialAttempt;
+        this.activeRelay = null;
+        this.pendingCandidate = null;
+        this.currentRelayUrl = null;
+        this.initialAttempt = null;
+        this.cancelInitialAttempt = null;
+        this.currentState = "idle";
+        this.setDisplayStatus("off");
+        cancel?.();
+        if (active)
+            this.closeCandidateOnce(active);
+        if (pending && pending !== active)
+            this.closeCandidateOnce(pending);
+        this.deps.onDisconnected();
+        this.deps.onStateChange();
+    }
+    async startInitial(ctx, expectedGeneration) {
+        let identity;
+        try {
+            identity = await this.deps.loadIdentity();
+        }
+        catch (error) {
+            if (!this.isOperationCurrent(expectedGeneration))
+                return;
+            if (this.deps.handleIdentityError(error, ctx)) {
+                this.setDisplayStatus("failed");
+                return;
+            }
+            throw error;
+        }
+        if (!this.isOperationCurrent(expectedGeneration))
+            return;
+        this.identity = identity;
+        const resolution = this.deps.resolveRelayUrl();
+        this.currentRelayUrl = resolution.url;
+        this.currentState = "started";
+        this.deps.onStateChange();
+        this.notify(ctx, this.deps.describeConnection(resolution));
+        let options;
+        try {
+            options = await this.deps.buildConnectOptions(ctx.cwd);
+        }
+        catch (error) {
+            this.handleConnectionFailure(expectedGeneration, resolution.url, ctx, error);
+            return;
+        }
+        if (!this.isReconnectCurrent(expectedGeneration))
+            return;
+        const candidate = this.deps.createClient(resolution.url, identity);
+        this.pendingCandidate = candidate;
+        try {
+            await candidate.connect(options);
+        }
+        catch (error) {
+            this.clearCandidate(candidate, true);
+            this.handleConnectionFailure(expectedGeneration, resolution.url, ctx, error);
+            return;
+        }
+        if (!this.isReconnectCurrent(expectedGeneration) || this.pendingCandidate !== candidate) {
+            this.closeCandidateOnce(candidate);
+            return;
+        }
+        this.pendingCandidate = null;
+        this.activeRelay = candidate;
+        this.reconnectAttempt = 0;
+        this.setDisplayStatus("connected");
+        candidate.on("close", () => this.onRelayClose(candidate));
+        this.deps.onConnected(candidate, ctx);
+        this.deps.onStateChange();
+    }
+    scheduleReconnect(url) {
+        if (!this.identity || this.isDisposed || this.currentState !== "started")
+            return;
+        if (this.reconnectTimer)
+            clearTimeout(this.reconnectTimer);
+        const expectedGeneration = ++this.generation;
+        const delay = RECONNECT_BACKOFFS_MS[Math.min(this.reconnectAttempt++, RECONNECT_BACKOFFS_MS.length - 1)];
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            if (!this.isReconnectCurrent(expectedGeneration))
+                return;
+            void this.reconnect(url, expectedGeneration);
+        }, delay);
+    }
+    async reconnect(url, expectedGeneration) {
+        const identity = this.identity;
+        if (!identity || !this.isReconnectCurrent(expectedGeneration))
+            return;
+        let options;
+        try {
+            options = await this.deps.buildConnectOptions();
+        }
+        catch {
+            if (this.isReconnectCurrent(expectedGeneration)) {
+                this.deps.onStateChange();
+                this.scheduleReconnect(url);
+            }
+            return;
+        }
+        if (!this.isReconnectCurrent(expectedGeneration) || this.identity !== identity)
+            return;
+        const candidate = this.deps.createClient(url, identity);
+        this.pendingCandidate = candidate;
+        try {
+            await candidate.connect(options);
+        }
+        catch {
+            this.clearCandidate(candidate, true);
+            if (this.isReconnectCurrent(expectedGeneration)) {
+                this.deps.onStateChange();
+                this.scheduleReconnect(url);
+            }
+            return;
+        }
+        if (!this.isReconnectCurrent(expectedGeneration) || this.pendingCandidate !== candidate) {
+            this.closeCandidateOnce(candidate);
+            return;
+        }
+        this.pendingCandidate = null;
+        this.activeRelay = candidate;
+        this.reconnectAttempt = 0;
+        this.setDisplayStatus("connected");
+        candidate.on("close", () => this.onRelayClose(candidate));
+        this.deps.onConnected(candidate);
+        this.deps.onStateChange();
+    }
+    onRelayClose(closed) {
+        if (closed !== this.activeRelay || this.currentState === "idle")
+            return;
+        this.activeRelay = null;
+        this.setDisplayStatus("reconnecting");
+        this.deps.onDisconnected();
+        this.deps.onStateChange();
+        if (this.currentRelayUrl)
+            this.scheduleReconnect(this.currentRelayUrl);
+    }
+    handleConnectionFailure(expectedGeneration, url, ctx, error) {
+        if (!this.isReconnectCurrent(expectedGeneration))
+            return;
+        this.notify(ctx, `[pi-reach] Relay unavailable; reconnecting in background: ${String(error)}`, "warning");
+        this.setDisplayStatus("reconnecting");
+        this.deps.onStateChange();
+        this.scheduleReconnect(url);
+    }
+    markInitialFailure(expectedGeneration) {
+        if (!this.isOperationCurrent(expectedGeneration))
+            return;
+        const active = this.activeRelay;
+        const pending = this.pendingCandidate;
+        this.activeRelay = null;
+        this.pendingCandidate = null;
+        this.currentRelayUrl = null;
+        this.currentState = "idle";
+        this.reconnectAttempt = 0;
+        if (active)
+            this.closeCandidateOnce(active);
+        if (pending && pending !== active)
+            this.closeCandidateOnce(pending);
+        this.setDisplayStatus("failed");
+    }
+    setDisplayStatus(status) {
+        this.currentDisplayStatus = status;
+        // 本地展示状态不改变既有 Relay 控制事件的发送时机。
+        this.deps.onDisplayStatusChange();
+    }
+    clearCandidate(candidate, close) {
+        if (this.pendingCandidate !== candidate)
+            return;
+        this.pendingCandidate = null;
+        if (close)
+            this.closeCandidateOnce(candidate);
+    }
+    closeCandidateOnce(candidate) {
+        if (this.closedCandidates.has(candidate))
+            return;
+        this.closedCandidates.add(candidate);
+        candidate.close();
+    }
+    clearInitialAttempt(attempt, cancel) {
+        if (this.initialAttempt === attempt)
+            this.initialAttempt = null;
+        if (this.cancelInitialAttempt === cancel)
+            this.cancelInitialAttempt = null;
+    }
+    isOperationCurrent(expected) {
+        return !this.isDisposed && this.generation === expected;
+    }
+    isReconnectCurrent(expected) {
+        return this.currentState === "started" && this.isOperationCurrent(expected);
+    }
+    notify(ctx, message, kind = "info") {
+        try {
+            ctx.ui.notify(message, kind);
+        }
+        catch { /* stale context */ }
+    }
+}
+//# sourceMappingURL=relay_lifecycle.js.map

package/dist/runtime/relay_lifecycle.js.map

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

package/dist/session/local_config.d.ts

@@ -0,0 +1,7 @@
+export interface LocalConfig {
+    agent_name?: string;
+}
+export declare function localConfigExists(cwd: string): boolean;
+export declare function loadLocalConfig(cwd: string): LocalConfig;
+export declare function saveLocalConfig(cwd: string, patch: Partial<LocalConfig>): void;
+export declare function defaultAgentName(cwd: string): string;

package/dist/session/local_config.js

@@ -0,0 +1,52 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+const LOCAL_DIR = ".pi/pi-reach";
+const LOCAL_FILE = "config.json";
+function pathFor(cwd) {
+    return join(cwd, LOCAL_DIR, LOCAL_FILE);
+}
+function parseLocalConfig(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+        return null;
+    const agentName = parsed["agent_name"];
+    return typeof agentName === "string" && agentName.trim()
+        ? { agent_name: agentName.trim() }
+        : {};
+}
+export function localConfigExists(cwd) {
+    return existsSync(pathFor(cwd));
+}
+export function loadLocalConfig(cwd) {
+    const path = pathFor(cwd);
+    if (!existsSync(path))
+        return {};
+    try {
+        return parseLocalConfig(readFileSync(path, "utf8")) ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+export function saveLocalConfig(cwd, patch) {
+    const path = pathFor(cwd);
+    const next = { ...loadLocalConfig(cwd), ...patch };
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, JSON.stringify(next, null, 2));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`[pi-reach] could not persist local config ${path}: ${message}`);
+    }
+}
+export function defaultAgentName(cwd) {
+    return basename(cwd) || "agent";
+}
+//# sourceMappingURL=local_config.js.map

package/dist/session/local_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local_config.js","sourceRoot":"","sources":["../../src/session/local_config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,SAAS,GAAG,cAAc,CAAC;AACjC,MAAM,UAAU,GAAG,aAAa,CAAC;AAMjC,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IACnC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAChF,MAAM,SAAS,GAAI,MAAkC,CAAC,YAAY,CAAC,CAAC;IACpE,OAAO,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE;QACtD,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,IAAI,EAAE,EAAE;QAClC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,gBAAgB,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,KAA2B;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAgB,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;IAChE,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,6CAA6C,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC;AAClC,CAAC"}

package/dist/timeline/history.d.ts

@@ -0,0 +1,30 @@
+import type { SessionManager } from "@earendil-works/pi-coding-agent";
+import { type ServerFrame, type TimelineEvent } from "../protocol/v2/index.js";
+type RecoveryFn = (sessionManager: SessionManager) => readonly TimelineEvent[];
+type HistorySyncRequest = {
+    requestId: string;
+    targetChannelId: string;
+    leafId: string | null;
+    before: number | null;
+    limit?: number;
+};
+export type TimelineHistorySync = HistorySyncRequest;
+export type TimelineHistoryRecovery = RecoveryFn;
+export declare class TimelineHistoryPager {
+    private readonly sessionManager;
+    private readonly recoverFn;
+    constructor(sessionManager: SessionManager, recoverFn: RecoveryFn);
+    sync(request: HistorySyncRequest): ServerFrame[];
+    private validateRequest;
+    private captureSnapshot;
+    private snapshotInvalidReason;
+    private recoverRecords;
+    private selectWindow;
+    private fragmentWindow;
+    private makeChunk;
+    private nonFinalFrameBytes;
+    private finalFrameBytes;
+    private protocolError;
+    private reset;
+}
+export {};