@yefengr/pi-reach 0.0.0-stage → 0.0.2

package/dist/protocol/v2/session_state.d.ts

@@ -0,0 +1,79 @@
+export type V2IdempotencyStatus = "received" | "queued" | "accepted" | "committed" | "unknown_delivery";
+export type V2ChannelState = {
+    readonly senderRef: string;
+    readonly channelId: string;
+    readonly ready: true;
+    readonly lastSeen: number;
+};
+export type V2IdempotencyRequest = {
+    senderRef: string;
+    clientRequestId: string;
+    payload: unknown;
+};
+export type V2IdempotencyRecord = {
+    readonly key: string;
+    readonly sessionId: string;
+    readonly leafId: string | null;
+    readonly senderRef: string;
+    readonly clientRequestId: string;
+    readonly fingerprint: string;
+    status: V2IdempotencyStatus;
+    messageId?: string;
+    groupId?: string;
+    touchedAt: number;
+};
+type Clock = () => number;
+export type V2SessionStateOptions = {
+    sessionId: string;
+    leafId: string | null;
+    maxEntries?: number;
+    ttlMs?: number;
+    clock?: Clock;
+};
+type BeginResult = {
+    kind: "new";
+    record: V2IdempotencyRecord;
+} | {
+    kind: "replay";
+    record: V2IdempotencyRecord;
+} | {
+    kind: "conflict";
+    record: V2IdempotencyRecord;
+};
+export declare class V2SessionState {
+    private sessionIdValue;
+    private leafIdValue;
+    private readonly maxEntries;
+    private readonly ttlMs;
+    private readonly clock;
+    private readonly channels;
+    private readonly records;
+    constructor(options: V2SessionStateOptions);
+    get sessionId(): string;
+    get leafId(): string | null;
+    setScope(sessionId: string, leafId: string | null): void;
+    hello(senderRef: string, channelId: string): V2ChannelState;
+    touch(senderRef: string, channelId: string): V2ChannelState | undefined;
+    get(senderRef: string, channelId: string): V2ChannelState | undefined;
+    removeChannel(senderRef: string, channelId: string): void;
+    removeOwner(senderRef: string): void;
+    begin(request: V2IdempotencyRequest): BeginResult;
+    update(key: string, status: V2IdempotencyStatus, details?: {
+        messageId?: string;
+        groupId?: string;
+    }): V2IdempotencyRecord | undefined;
+    rememberUnknownDelivery(key: string): V2IdempotencyRecord | undefined;
+    getRecord(key: string): V2IdempotencyRecord | undefined;
+    forget(key: string): boolean;
+    snapshot(): {
+        channels: V2ChannelState[];
+        records: V2IdempotencyRecord[];
+    };
+    private prune;
+    private pruneCapacity;
+    private recordKey;
+    private channelKey;
+    private assertId;
+}
+export declare function fingerprintV2Payload(value: unknown): string;
+export {};

package/dist/protocol/v2/session_state.js

@@ -0,0 +1,166 @@
+import { createHash } from "node:crypto";
+export class V2SessionState {
+    sessionIdValue;
+    leafIdValue;
+    maxEntries;
+    ttlMs;
+    clock;
+    channels = new Map();
+    records = new Map();
+    constructor(options) {
+        this.assertId(options.sessionId, "sessionId");
+        this.sessionIdValue = options.sessionId;
+        this.leafIdValue = options.leafId;
+        this.maxEntries = Math.max(1, Math.floor(options.maxEntries ?? 512));
+        this.ttlMs = Math.max(1, options.ttlMs ?? 10 * 60 * 1000);
+        this.clock = options.clock ?? Date.now;
+    }
+    get sessionId() {
+        return this.sessionIdValue;
+    }
+    get leafId() {
+        return this.leafIdValue;
+    }
+    setScope(sessionId, leafId) {
+        this.assertId(sessionId, "sessionId");
+        if (sessionId === this.sessionIdValue && leafId === this.leafIdValue)
+            return;
+        this.sessionIdValue = sessionId;
+        this.leafIdValue = leafId;
+        this.records.clear();
+    }
+    hello(senderRef, channelId) {
+        this.assertId(senderRef, "senderRef");
+        this.assertId(channelId, "channelId");
+        const state = { senderRef, channelId, ready: true, lastSeen: this.clock() };
+        this.channels.set(this.channelKey(senderRef, channelId), state);
+        return state;
+    }
+    touch(senderRef, channelId) {
+        const current = this.get(senderRef, channelId);
+        if (!current)
+            return undefined;
+        const state = { ...current, lastSeen: this.clock() };
+        this.channels.set(this.channelKey(senderRef, channelId), state);
+        return state;
+    }
+    get(senderRef, channelId) {
+        return this.channels.get(this.channelKey(senderRef, channelId));
+    }
+    removeChannel(senderRef, channelId) {
+        this.channels.delete(this.channelKey(senderRef, channelId));
+    }
+    removeOwner(senderRef) {
+        for (const [key, channel] of this.channels)
+            if (channel.senderRef === senderRef)
+                this.channels.delete(key);
+        for (const [key, record] of this.records)
+            if (record.senderRef === senderRef)
+                this.records.delete(key);
+    }
+    begin(request) {
+        this.prune();
+        this.assertId(request.senderRef, "senderRef");
+        this.assertId(request.clientRequestId, "clientRequestId");
+        const key = this.recordKey(request.senderRef, request.clientRequestId);
+        const fingerprint = fingerprintPayload(request.payload);
+        const existing = this.records.get(key);
+        if (existing) {
+            existing.touchedAt = this.clock();
+            this.records.delete(key);
+            this.records.set(key, existing);
+            return { kind: existing.fingerprint === fingerprint ? "replay" : "conflict", record: { ...existing } };
+        }
+        const record = {
+            key,
+            sessionId: this.sessionIdValue,
+            leafId: this.leafIdValue,
+            senderRef: request.senderRef,
+            clientRequestId: request.clientRequestId,
+            fingerprint,
+            status: "received",
+            touchedAt: this.clock(),
+        };
+        this.records.set(key, record);
+        this.pruneCapacity();
+        return { kind: "new", record: { ...record } };
+    }
+    update(key, status, details = {}) {
+        this.prune();
+        const record = this.records.get(key);
+        if (!record)
+            return undefined;
+        record.status = status;
+        if (details.messageId !== undefined)
+            record.messageId = details.messageId;
+        if (details.groupId !== undefined)
+            record.groupId = details.groupId;
+        record.touchedAt = this.clock();
+        this.records.delete(key);
+        this.records.set(key, record);
+        return { ...record };
+    }
+    rememberUnknownDelivery(key) {
+        return this.update(key, "unknown_delivery");
+    }
+    getRecord(key) {
+        this.prune();
+        const record = this.records.get(key);
+        return record ? { ...record } : undefined;
+    }
+    forget(key) {
+        return this.records.delete(key);
+    }
+    snapshot() {
+        this.prune();
+        return { channels: [...this.channels.values()].map((channel) => ({ ...channel })), records: [...this.records.values()].map((record) => ({ ...record })) };
+    }
+    prune() {
+        const now = this.clock();
+        for (const [key, record] of this.records)
+            if (now - record.touchedAt >= this.ttlMs)
+                this.records.delete(key);
+        this.pruneCapacity();
+    }
+    pruneCapacity() {
+        while (this.records.size > this.maxEntries) {
+            const oldest = this.records.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.records.delete(oldest);
+        }
+    }
+    recordKey(senderRef, clientRequestId) {
+        return `${this.sessionIdValue}\u0000${this.leafIdValue ?? ""}\u0000${senderRef}\u0000${clientRequestId}`;
+    }
+    channelKey(senderRef, channelId) {
+        return `${senderRef}\u0000${channelId}`;
+    }
+    assertId(value, name) {
+        if (!value || value.length > 256)
+            throw new Error(`${name} is invalid`);
+    }
+}
+function fingerprintPayload(value) {
+    const canonical = canonicalize(value);
+    return createHash("sha256").update(JSON.stringify(canonical), "utf8").digest("hex");
+}
+function canonicalize(value) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : null;
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (typeof value === "object") {
+        const result = {};
+        for (const key of Object.keys(value).sort())
+            result[key] = canonicalize(value[key]);
+        return result;
+    }
+    return String(value);
+}
+export function fingerprintV2Payload(value) {
+    return fingerprintPayload(value);
+}
+//# sourceMappingURL=session_state.js.map

package/dist/protocol/v2/session_state.js.map

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

package/dist/runtime/endpoint_metadata.d.ts

@@ -0,0 +1,14 @@
+import type { SessionManager } from "@earendil-works/pi-coding-agent";
+import type { EndpointMetadata } from "../transport/relay_client.js";
+export declare const UNTITLED_SESSION_NAME = "Untitled session";
+type SessionNameSource = Pick<SessionManager, "getSessionName"> | null | undefined;
+type EndpointMetadataInput = {
+    sessionManager: SessionNameSource;
+    cwd: string;
+    model?: string;
+    thinking?: string;
+    working: boolean;
+};
+export declare function currentSessionName(sessionManager: SessionNameSource): string;
+export declare function buildEndpointMetadata({ sessionManager, cwd, model, thinking, working, }: EndpointMetadataInput): EndpointMetadata;
+export {};

package/dist/runtime/endpoint_metadata.js

@@ -0,0 +1,18 @@
+export const UNTITLED_SESSION_NAME = "Untitled session";
+export function currentSessionName(sessionManager) {
+    const name = sessionManager?.getSessionName?.();
+    return name?.trim() || UNTITLED_SESSION_NAME;
+}
+export function buildEndpointMetadata({ sessionManager, cwd, model, thinking, working, }) {
+    return {
+        kind: "interactive",
+        name: currentSessionName(sessionManager),
+        cwd,
+        pid: process.pid,
+        started_at: Date.now(),
+        ...(model ? { model } : {}),
+        ...(thinking ? { thinking } : {}),
+        working,
+    };
+}
+//# sourceMappingURL=endpoint_metadata.js.map

package/dist/runtime/endpoint_metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint_metadata.js","sourceRoot":"","sources":["../../src/runtime/endpoint_metadata.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAYxD,MAAM,UAAU,kBAAkB,CAAC,cAAiC;IAClE,MAAM,IAAI,GAAG,cAAc,EAAE,cAAc,EAAE,EAAE,CAAC;IAChD,OAAO,IAAI,EAAE,IAAI,EAAE,IAAI,qBAAqB,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,EACpC,cAAc,EACd,GAAG,EACH,KAAK,EACL,QAAQ,EACR,OAAO,GACe;IACtB,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,kBAAkB,CAAC,cAAc,CAAC;QACxC,GAAG;QACH,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;QACtB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/runtime/extension_owner.d.ts

@@ -0,0 +1,12 @@
+import type { ExtensionAPI, ExtensionContext, SessionShutdownEvent, SessionStartEvent } from "@earendil-works/pi-coding-agent";
+/** 一个进程只暴露主会话；同进程 SDK 子会话不得接管它的连接或生命周期。 */
+export declare class ExtensionOwner {
+    private rejected;
+    private session;
+    isCurrent(): boolean;
+    activate(event: SessionStartEvent, ctx: ExtensionContext): boolean;
+    release(event: SessionShutdownEvent): void;
+    private matchesHandoff;
+    guard(pi: ExtensionAPI): ExtensionAPI;
+}
+export declare function resetExtensionOwnerForTest(): void;

package/dist/runtime/extension_owner.js

@@ -0,0 +1,80 @@
+const OWNER_KEY = Symbol.for("pi-reach.endpoint-extension-owner");
+function ownerState() {
+    return globalThis[OWNER_KEY] ??= {};
+}
+/** 一个进程只暴露主会话；同进程 SDK 子会话不得接管它的连接或生命周期。 */
+export class ExtensionOwner {
+    rejected = false;
+    session;
+    isCurrent() {
+        return ownerState().owner === this;
+    }
+    activate(event, ctx) {
+        if (this.rejected)
+            return false;
+        const state = ownerState();
+        if (state.owner && state.owner !== this) {
+            this.rejected = true;
+            return false;
+        }
+        const session = { sessionId: ctx.sessionManager.getSessionId(), sessionFile: ctx.sessionManager.getSessionFile?.() };
+        const handoff = state.handoff;
+        if (handoff && !this.matchesHandoff(handoff, event, session)) {
+            this.rejected = true;
+            return false;
+        }
+        state.owner = this;
+        state.handoff = undefined;
+        this.session = session;
+        return true;
+    }
+    release(event) {
+        if (!this.isCurrent())
+            return;
+        const state = ownerState();
+        state.owner = undefined;
+        state.handoff = event.reason !== "quit" && this.session
+            ? { ...this.session, owner: this, reason: event.reason, targetSessionFile: event.targetSessionFile }
+            : undefined;
+        // 即使主会话已退出，先前拒绝的子实例也不能由后续事件抢占 endpoint。
+    }
+    matchesHandoff(handoff, event, session) {
+        if (event.reason !== handoff.reason)
+            return false;
+        if (event.reason === "reload")
+            return session.sessionId === handoff.sessionId;
+        if (event.previousSessionFile !== handoff.sessionFile)
+            return false;
+        return !handoff.targetSessionFile || session.sessionFile === handoff.targetSessionFile;
+    }
+    guard(pi) {
+        const on = ((name, handler) => {
+            pi.on(name, (...args) => this.isCurrent() ? handler(...args) : undefined);
+        });
+        const registerCommand = (name, command) => {
+            pi.registerCommand(name, {
+                ...command,
+                handler: async (args, ctx) => {
+                    if (!this.isCurrent() && ownerState().handoff?.owner !== this) {
+                        ctx.ui.notify("[pi-reach] This endpoint belongs to the primary Pi session.", "warning");
+                        return;
+                    }
+                    await command.handler(args, ctx);
+                },
+            });
+        };
+        return new Proxy(pi, {
+            get(target, key, receiver) {
+                if (key === "on")
+                    return on;
+                if (key === "registerCommand")
+                    return registerCommand;
+                return Reflect.get(target, key, receiver);
+            },
+        });
+    }
+}
+export function resetExtensionOwnerForTest() {
+    delete globalThis[OWNER_KEY];
+}
+//# sourceMappingURL=extension_owner.js.map

package/dist/runtime/extension_owner.js.map

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

package/dist/runtime/footer.d.ts

@@ -0,0 +1,6 @@
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { RelayDisplayStatus } from "./relay_lifecycle.js";
+type FooterUi = Pick<ExtensionContext["ui"], "setStatus" | "theme">;
+export declare function clearLegacyRelayStatuses(ui: FooterUi): void;
+export declare function renderRelayFooter(ui: FooterUi, displayStatus: RelayDisplayStatus): void;
+export {};

package/dist/runtime/footer.js

@@ -0,0 +1,21 @@
+const LEGACY_STATUS_KEYS = ["pi-reach:control", "pi-reach:owner-active", "pi-reach:session"];
+const STATUS_PRESENTATION = {
+    connecting: { color: "dim", text: "连接中" },
+    connected: { color: "dim", text: "已连接" },
+    reconnecting: { color: "warning", text: "重连中" },
+    off: { color: "dim", text: "已关闭" },
+    failed: { color: "error", text: "启动失败" },
+};
+export function clearLegacyRelayStatuses(ui) {
+    for (const key of LEGACY_STATUS_KEYS)
+        ui.setStatus(key, undefined);
+}
+export function renderRelayFooter(ui, displayStatus) {
+    const { color, text } = STATUS_PRESENTATION[displayStatus];
+    const prefix = "Pi Reach · ";
+    const status = color === "dim"
+        ? ui.theme.fg("dim", prefix + text)
+        : ui.theme.fg("dim", prefix) + ui.theme.fg(color, text);
+    ui.setStatus("pi-reach:relay", status);
+}
+//# sourceMappingURL=footer.js.map

package/dist/runtime/footer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer.js","sourceRoot":"","sources":["../../src/runtime/footer.ts"],"names":[],"mappings":"AAKA,MAAM,kBAAkB,GAAG,CAAC,kBAAkB,EAAE,uBAAuB,EAAE,kBAAkB,CAAU,CAAC;AACtG,MAAM,mBAAmB,GAAG;IAC1B,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;IACzC,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;IACxC,YAAY,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE;IAC/C,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;IAClC,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE;CACkD,CAAC;AAE7F,MAAM,UAAU,wBAAwB,CAAC,EAAY;IACnD,KAAK,MAAM,GAAG,IAAI,kBAAkB;QAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAY,EAAE,aAAiC;IAC/E,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,aAAa,CAAC;IAC7B,MAAM,MAAM,GAAG,KAAK,KAAK,KAAK;QAC5B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1D,EAAE,CAAC,SAAS,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/runtime/owner_router.d.ts

@@ -0,0 +1,16 @@
+import { type ClientFrame } from "../protocol/v2/index.js";
+import type { RelayClient } from "../transport/relay_client.js";
+import { type HostRouteIdentity } from "../transport/peer_channel.js";
+export interface OwnerRouterDependencies {
+    isCurrent(relay: RelayClient): boolean;
+    routeIdentity(): HostRouteIdentity;
+    hasOwner(ownerId: string): boolean;
+    findKnownOwner(ownerId: string): Promise<boolean>;
+    attachOwner(relay: RelayClient, ownerId: string): void;
+    routeClientFrame(ownerId: string, frame: ClientFrame): void;
+    handlePairRequest(relay: RelayClient, ownerId: string, frame: Extract<ClientFrame, {
+        type: "pair_request";
+    }>): Promise<void>;
+}
+/** Routes unbound Owner frames without duplicating bound peer-channel traffic. */
+export declare function installOwnerRouter(relay: RelayClient, deps: OwnerRouterDependencies): () => void;

package/dist/runtime/owner_router.js

@@ -0,0 +1,41 @@
+import { decodeClientFrameV2 } from "../protocol/v2/index.js";
+import { decodeRoutePayload } from "../vendor/protocol/outer/index.js";
+import { parseIncomingRoute } from "../transport/peer_channel.js";
+/** Routes unbound Owner frames without duplicating bound peer-channel traffic. */
+export function installOwnerRouter(relay, deps) {
+    const listener = (line) => {
+        if (!deps.isCurrent(relay))
+            return;
+        const route = parseIncomingRoute(line, deps.routeIdentity());
+        if (!route?.source_owner_id)
+            return;
+        const payload = decodeRoutePayload(route);
+        if (!payload)
+            return;
+        let frame;
+        try {
+            frame = decodeClientFrameV2(payload);
+        }
+        catch {
+            return;
+        }
+        if ((frame.type === "pair_request") !== (route.purpose === "pairing"))
+            return;
+        const ownerId = route.source_owner_id;
+        if (frame.type === "pair_request") {
+            void deps.handlePairRequest(relay, ownerId, frame);
+            return;
+        }
+        if (deps.hasOwner(ownerId))
+            return;
+        void deps.findKnownOwner(ownerId).then((known) => {
+            if (!known || !deps.isCurrent(relay))
+                return;
+            deps.attachOwner(relay, ownerId);
+            deps.routeClientFrame(ownerId, frame);
+        });
+    };
+    relay.on("message", listener);
+    return () => relay.off("message", listener);
+}
+//# sourceMappingURL=owner_router.js.map

package/dist/runtime/owner_router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner_router.js","sourceRoot":"","sources":["../../src/runtime/owner_router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAoB,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAA0B,MAAM,8BAA8B,CAAC;AAY1F,kFAAkF;AAClF,MAAM,UAAU,kBAAkB,CAAC,KAAkB,EAAE,IAA6B;IAClF,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAQ,EAAE;QACtC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,OAAO;QACnC,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,KAAK,EAAE,eAAe;YAAE,OAAO;QACpC,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,KAAkB,CAAC;QACvB,IAAI,CAAC;YAAC,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAAC,CAAC;QAC7C,MAAM,CAAC;YAAC,OAAO;QAAC,CAAC;QACjB,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC;YAAE,OAAO;QAC9E,MAAM,OAAO,GAAG,KAAK,CAAC,eAAe,CAAC;QACtC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAClC,KAAK,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO;QACnC,KAAK,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YAC/C,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;gBAAE,OAAO;YAC7C,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACjC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9B,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC"}

package/dist/runtime/pairing_coordinator.d.ts

@@ -0,0 +1,42 @@
+import type { PeerRecord, PeerWriteReceipt } from "../pairing/storage.js";
+import type { QRSession } from "../pairing/qr.js";
+import type { ClientFrame, ServerFrame } from "../protocol/v2/index.js";
+import type { RelayClient } from "../transport/relay_client.js";
+import { V2PeerChannel, type HostRouteIdentity } from "../transport/peer_channel.js";
+type PairRequest = Extract<ClientFrame, {
+    type: "pair_request";
+}>;
+type PairOk = Extract<ServerFrame, {
+    type: "pair_ok";
+}>;
+export interface PairingBinding {
+    readonly channel: V2PeerChannel;
+}
+export interface PairingCoordinatorDependencies {
+    readonly qrSession: QRSession;
+    readonly routeIdentity: () => HostRouteIdentity;
+    readonly isRelayCurrent: (relay: RelayClient) => boolean;
+    readonly attachOwner: (relay: RelayClient, ownerId: string) => PairingBinding | null;
+    readonly activeBinding: (ownerId: string) => PairingBinding | undefined;
+    readonly addPeer: (record: PeerRecord) => Promise<PeerWriteReceipt>;
+    readonly rollbackPeer: (receipt: PeerWriteReceipt) => Promise<unknown>;
+    readonly updateEndpoint: (relay: RelayClient) => Promise<boolean>;
+    readonly refreshCurrentEndpoint: () => Promise<boolean>;
+    readonly buildPairOk: (frame: PairRequest) => PairOk;
+}
+/** Coordinates one-process pairing retries across storage and Relay lifecycles. */
+export declare class PairingCoordinator {
+    private readonly deps;
+    private readonly attempts;
+    constructor(deps: PairingCoordinatorDependencies);
+    handle(relay: RelayClient, ownerId: string, frame: PairRequest): Promise<void>;
+    abandonInactive(): void;
+    private run;
+    private rollback;
+    private lifecycleIsCurrent;
+    private canCommit;
+    private reject;
+    private sendError;
+    private attemptKey;
+}
+export {};