@codetreker/daynight 0.25.2 → 0.26.0

package/dist/commands/controller/providers/projection.js

@@ -0,0 +1,99 @@
+import { createHash } from "node:crypto";
+import { record, string } from "./native-rpc.js";
+// Native item IDs survive reconnects; transport IDs must never create new timeline rows.
+export const nativeEntryId = (session, item) => {
+    const h = createHash("sha256").update(session).update("\0").update(item).digest("hex");
+    return `${h.slice(0, 8)}-${h.slice(8, 12)}-4${h.slice(13, 16)}-8${h.slice(17, 20)}-${h.slice(20, 32)}`;
+};
+export const readable = (value) => typeof value === "string" ? value : JSON.stringify(value, null, 2) ?? "";
+export const limited = (value) => {
+    if (value.length <= 200_000)
+        return value;
+    // UTF-16 limits must not split a scalar value accepted by the wire codec.
+    const end = /[\uD800-\uDBFF]/.test(value[199_999]) && /[\uDC00-\uDFFF]/.test(value[200_000]) ? 199_999 : 200_000;
+    return value.slice(0, end) + "\n[Output truncated at 200000 characters]";
+};
+export const parseProviderArguments = (provider, args) => {
+    const result = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i], value = args[++i];
+        if (!value)
+            throw new Error(`Unsupported or incomplete Web ${provider} argument: ${arg}`);
+        if (provider === "codex" && ["--sandbox", "-s"].includes(arg) && ["read-only", "workspace-write"].includes(value))
+            result.sandbox = value;
+        else if (provider === "codex" && ["--ask-for-approval", "-a"].includes(arg) && ["untrusted", "on-request", "never"].includes(value))
+            result.approvalPolicy = value;
+        else if (provider === "claude" && arg === "--permission-mode" && ["default", "acceptEdits", "plan"].includes(value))
+            result.permissionMode = value;
+        else if (arg === "--effort" && (provider === "copilot" ? ["low", "medium", "high", "xhigh"] : ["low", "medium", "high", "xhigh", "max"]).includes(value))
+            result.effort = value;
+        else if (provider === "claude" && arg === "--add-dir")
+            (result.additionalDirectories ??= []).push(value);
+        else
+            throw new Error(`Unsupported Web ${provider} argument: ${arg}`);
+    }
+    return result;
+};
+export class CodexProjection {
+    sessionId;
+    emit;
+    content = new Map();
+    tools = new Map();
+    constructor(sessionId, emit) {
+        this.sessionId = sessionId;
+        this.emit = emit;
+    }
+    base(id) { return { entryId: nativeEntryId(this.sessionId, id), revision: "1" }; }
+    delta(id, delta, kind) {
+        const value = (this.content.get(id) ?? "") + delta;
+        this.content.set(id, value);
+        if (kind === "reasoning" && value.trim() === "")
+            return;
+        this.emit(kind === "reasoning" ? { ...this.base(id), kind, text: limited(value) } : { ...this.base(id), kind, content: [{ type: "text", text: limited(value) }] });
+    }
+    toolDelta(id, delta) {
+        const old = this.tools.get(id);
+        if (!old)
+            return;
+        const prior = old.output.map(part => part.type === "text" ? part.text : "").join("");
+        const output = prior + delta;
+        const entry = { ...old, output: [{ type: "text", text: limited(output) }], truncated: old.truncated || output.length > 200_000 };
+        this.tools.set(id, entry);
+        this.emit(entry);
+    }
+    item(value, completed) {
+        const item = record(value), id = string(item.id), type = string(item.type);
+        if (!id)
+            return;
+        const base = this.base(id);
+        if (type === "agentMessage") {
+            const text = string(item.text);
+            this.content.set(id, text);
+            this.emit({ ...base, kind: "assistant_message", content: [{ type: "text", text: limited(text) }] });
+        }
+        else if (type === "userMessage")
+            this.emit({ ...base, kind: "user_message", content: (Array.isArray(item.content) ? item.content : []).flatMap(part => { const p = record(part); return p.type === "text" ? [{ type: "text", text: limited(string(p.text)) }] : [{ type: "text", text: `[${string(p.type) || "unsupported native content"}]` }]; }) });
+        else if (type === "reasoning") {
+            const text = [...(Array.isArray(item.summary) ? item.summary : []), ...(Array.isArray(item.content) ? item.content : [])].map(readable).join("\n");
+            // Empty native reasoning can contain only opaque provider state. It is
+            // neither displayable text nor evidence that streamed text was removed.
+            if (text.trim() === "")
+                return;
+            this.content.set(id, text);
+            this.emit({ ...base, kind: "reasoning", text: limited(text) });
+        }
+        else if (["commandExecution", "fileChange", "mcpToolCall", "dynamicToolCall", "webSearch", "imageView", "collabAgentToolCall"].includes(type)) {
+            const output = readable(item.aggregatedOutput ?? item.result ?? item.error ?? item.changes ?? "");
+            const entry = { ...base, kind: "tool_call", callId: id, name: string(item.tool) || type, input: limited(readable(item.command ?? item.arguments ?? item.query ?? item.changes ?? item)), output: [{ type: "text", text: limited(output) }], status: ["failed", "declined"].includes(string(item.status)) || item.error ? "failed" : completed ? "completed" : "running", truncated: output.length > 200_000 };
+            this.tools.set(id, entry);
+            this.emit(entry);
+        }
+        else if (type === "contextCompaction")
+            this.emit({ ...base, kind: "compaction", summary: "Native conversation context compacted." });
+        else if (type === "plan")
+            this.emit({ ...base, kind: "assistant_message", content: [{ type: "text", text: limited(string(item.text) || readable(item)) }] });
+        else
+            this.emit({ ...base, kind: "error", code: "unsupported_native_item", message: `Unsupported native timeline item: ${type || "unknown"}. ${limited(readable(item))}` });
+    }
+}
+//# sourceMappingURL=projection.js.map

package/dist/commands/controller/providers/projection.js.map

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

package/dist/commands/controller/providers/turns.d.ts

@@ -0,0 +1,7 @@
+export declare class NativeTurns {
+    private readonly completed;
+    private readonly waiters;
+    isComplete(id: string): boolean;
+    complete(id: string, error: Error | null): void;
+    wait(id: string, deadline: number): Promise<void>;
+}

package/dist/commands/controller/providers/turns.js

@@ -0,0 +1,21 @@
+export class NativeTurns {
+    completed = new Map();
+    waiters = new Map();
+    isComplete(id) { return this.completed.has(id); }
+    complete(id, error) { this.completed.set(id, error); for (const resolve of this.waiters.get(id) ?? [])
+        resolve(error); this.waiters.delete(id); }
+    wait(id, deadline) {
+        if (this.completed.has(id)) {
+            const error = this.completed.get(id);
+            return error ? Promise.reject(error) : Promise.resolve();
+        }
+        return new Promise((resolve, reject) => {
+            const finish = (error) => { clearTimeout(timer); this.waiters.get(id)?.delete(finish); error ? reject(error) : resolve(); };
+            const timer = setTimeout(() => finish(new Error("Native turn completion is unknown after its deadline.")), Math.max(0, deadline - Date.now()));
+            const waiters = this.waiters.get(id) ?? new Set();
+            waiters.add(finish);
+            this.waiters.set(id, waiters);
+        });
+    }
+}
+//# sourceMappingURL=turns.js.map

package/dist/commands/controller/providers/turns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turns.js","sourceRoot":"","sources":["../../../../src/commands/controller/providers/turns.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAW;IACL,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC5C,OAAO,GAAG,IAAI,GAAG,EAA8C,CAAC;IACjF,UAAU,CAAC,EAAU,IAAa,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClE,QAAQ,CAAC,EAAU,EAAE,KAAmB,IAAU,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7K,IAAI,CAAC,EAAU,EAAE,QAAgB;QAC/B,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAAC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAAC,OAAO,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAAC,CAAC;QAC/H,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,CAAC,KAAmB,EAAE,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1I,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAC/I,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;YAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACxG,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/commands/controller/providers/types.d.ts

@@ -0,0 +1,44 @@
+import type { SessionControls } from "../../../session/controls.js";
+import type { ChildProcess } from "node:child_process";
+import type { InteractionResponse, SessionCapabilities, SessionSnapshot, TimelineEntry } from "../../../session/protocol.js";
+export type ProviderEntry = TimelineEntry extends infer T ? T extends TimelineEntry ? Omit<T, "entrySeq"> : never : never;
+export type ProviderState = {
+    nativeSessionId: string | null;
+    activity: SessionSnapshot["activity"];
+    currentTurnId: string | null;
+    capabilities: SessionCapabilities;
+    controls?: SessionControls;
+    turnStartedAt?: string | null;
+};
+export type ProviderOptions = {
+    cwd: string;
+    model: string | null;
+    args: readonly string[];
+    resumeNativeSessionId: string | null;
+    unattended?: boolean;
+    env?: NodeJS.ProcessEnv;
+    executable?: string;
+    controlsRevisionFloor?: string;
+    onTimeline(entry: ProviderEntry): void;
+    onState(state: ProviderState): void;
+    onSpawn(child: ChildProcess): void;
+    onDiagnostic?(line: string): void;
+    onFatalError?(error: Error): void;
+    onControlConfirmed?(operationId: string): void;
+    onInputObserved?(operationId: string): void;
+};
+export type ProviderReceipt = {
+    disposition: "started" | "queued" | "handled";
+    turnId?: string;
+};
+export interface NativeProvider {
+    readonly nativeSessionId: string;
+    send(text: string, operationId: string, expectedTurnId: string | null): Promise<ProviderReceipt>;
+    cancel(expectedTurnId: string): Promise<ProviderReceipt>;
+    respond(interactionId: string, revision: string, response: InteractionResponse): Promise<ProviderReceipt>;
+    setSetting?(settingId: string, value: string, operationId: string, expectedControlsRevision: string): Promise<ProviderReceipt>;
+    executeCommand?(commandId: string, args: string, operationId: string, expectedControlsRevision: string, expectedTurnId: string | null): Promise<ProviderReceipt>;
+    refreshControls?(): Promise<ProviderReceipt>;
+    waitForTurn(turnId: string, deadline: number): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/commands/controller/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/commands/controller/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/commands/controller/providers/types.ts"],"names":[],"mappings":""}

package/dist/commands/controller/recovery.d.ts

@@ -0,0 +1,6 @@
+import type { ControllerLifecycleStore, ControllerOperation } from "./lifecycle-store.js";
+export declare const isCleaningGeneration: (operations: readonly ControllerOperation[], generation: string) => boolean;
+/** A native user-message identity proves receipt, not successful turn completion. */
+export declare const observeNativeInput: (journal: ControllerLifecycleStore, operationId: string) => boolean;
+/** A late native resolution can settle a timed-out response without resubmitting it. */
+export declare const observeNativeInteraction: (journal: ControllerLifecycleStore, interactionId: string, generation: string) => ControllerOperation[];

package/dist/commands/controller/recovery.js

@@ -0,0 +1,22 @@
+export const isCleaningGeneration = (operations, generation) => operations.some(operation => operation.kind === "cleanup" && operation.executionGeneration === generation);
+/** A native user-message identity proves receipt, not successful turn completion. */
+export const observeNativeInput = (journal, operationId) => {
+    const operation = journal.getOperation(operationId);
+    if (!operation || !["initial", "send_message", "execute_command"].includes(operation.kind) || !["dispatching", "unknown"].includes(operation.state))
+        return false;
+    journal.recordOperation(operationId, "provider_accepted", operation.result);
+    return true;
+};
+/** A late native resolution can settle a timed-out response without resubmitting it. */
+export const observeNativeInteraction = (journal, interactionId, generation) => {
+    const receipts = [];
+    for (const operation of journal.listOperations()) {
+        if (operation.executionGeneration !== generation || operation.kind !== "interaction_response" || !["dispatching", "provider_accepted", "unknown"].includes(operation.state))
+            continue;
+        if (!operation.payload || typeof operation.payload !== "object" || !("interactionId" in operation.payload) || operation.payload.interactionId !== interactionId)
+            continue;
+        receipts.push(journal.recordOperation(operation.operationId, "confirmed", { disposition: "handled" }));
+    }
+    return receipts;
+};
+//# sourceMappingURL=recovery.js.map

package/dist/commands/controller/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../../src/commands/controller/recovery.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAA0C,EAAE,UAAkB,EAAW,EAAE,CAC9G,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,mBAAmB,KAAK,UAAU,CAAC,CAAC;AAE7G,qFAAqF;AACrF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAiC,EAAE,WAAmB,EAAW,EAAE;IACpG,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACpD,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAClK,OAAO,CAAC,eAAe,CAAC,WAAW,EAAE,mBAAmB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5E,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,wFAAwF;AACxF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,OAAiC,EAAE,aAAqB,EAAE,UAAkB,EAAyB,EAAE;IAC9I,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAC3C,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QACjD,IAAI,SAAS,CAAC,mBAAmB,KAAK,UAAU,IAAI,SAAS,CAAC,IAAI,KAAK,sBAAsB,IAAI,CAAC,CAAC,aAAa,EAAE,mBAAmB,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,SAAS;QACtL,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,eAAe,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,aAAa,KAAK,aAAa;YAAE,SAAS;QAC1K,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/dist/commands/controller/relay.d.ts

@@ -0,0 +1,18 @@
+import { type SessionCommand, type SessionOperation } from "../../session/protocol.js";
+import { type ControllerGrantResponse, type ControllerState } from "../../session/controller-protocol.js";
+import type { ControllerLaunchTicket } from "./launch-ticket.js";
+import type { ControllerLifecycleStore, ControllerOperation } from "./lifecycle-store.js";
+export declare const publicOperation: (ticket: ControllerLaunchTicket, operation: ControllerOperation) => SessionOperation;
+export declare const readControllerGrant: (ticket: ControllerLaunchTicket) => Promise<ControllerGrantResponse>;
+export declare const createControllerRelay: (ticket: ControllerLaunchTicket, journal: ControllerLifecycleStore, callbacks: {
+    onConnection(connected: boolean): void;
+    onCommand(command: SessionCommand): Promise<void>;
+    onError(message: string): void;
+    readState?(): ControllerState;
+}) => {
+    connected: () => boolean;
+    authorize: (operationId: string) => Promise<void>;
+    receipt: (operation: ControllerOperation) => void;
+    flush(timeoutMs?: number): Promise<void>;
+    close: () => void;
+};

package/dist/commands/controller/relay.js

@@ -0,0 +1,299 @@
+import { sessionDisplayEntry, sessionWireBytes } from "./wire-display.js";
+import { sessionFence } from "../../session/protocol.js";
+import { readFile, lstat } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import WebSocket from "ws";
+import { SESSION_PROTOCOL } from "../../session/protocol.js";
+import { RELAY_LIMITS, parseControllerGrantResponse, parseRelayMessage } from "../../session/controller-protocol.js";
+export const publicOperation = (ticket, operation) => ({ protocol: SESSION_PROTOCOL, ...sessionFence(ticket), executionGeneration: operation.executionGeneration ?? ticket.executionGeneration, operationId: operation.operationId, kind: operation.kind === "initial" || operation.kind === "cleanup" ? "send_message" : operation.kind, state: operation.state, providerResult: operation.result?.disposition ?? null, error: operation.error ? { code: "native_operation_error", message: operation.error } : null });
+export const readControllerGrant = async (ticket) => {
+    const metadata = await lstat(ticket.credentialFile);
+    if (!metadata.isFile() || metadata.isSymbolicLink() || metadata.size > 16_384 || process.platform !== "win32" && (metadata.mode & 0o077) !== 0)
+        throw new Error("Controller credential must be a private regular file.");
+    const grant = parseControllerGrantResponse(JSON.parse(await readFile(ticket.credentialFile, "utf8")));
+    if (grant.sessionId !== ticket.sessionId || grant.claimId !== ticket.claimId || grant.testExecutionId !== ticket.testExecutionId || grant.executionGeneration !== ticket.executionGeneration || grant.controllerId !== ticket.controllerId || grant.controllerInstanceId !== ticket.controllerInstanceId || Date.parse(grant.expiresAt) <= Date.now())
+        throw new Error("Controller credential is stale or belongs to another execution.");
+    return grant;
+};
+export const createControllerRelay = (ticket, journal, callbacks) => {
+    let socket = null, fence = null, stopped = false, synchronized = false;
+    let reconciled = false, requiresLiveSync = false, syncPending = false, connectionFloor = "0";
+    let historyEpoch = "";
+    const contentRequests = [];
+    let reconciliation = [];
+    let pendingBatch = null, currentToken = "", lastHeartbeat = 0, reconnectAt = 0, connecting = false;
+    const authorization = new Map();
+    const settleDispatchRefusal = (operation, required = false, currentConnection = false) => {
+        const local = journal.getOperation(operation.operationId);
+        if (!required && local?.state !== "accepted")
+            return;
+        if (!local || local.state !== "accepted" || operation.kind !== local.kind || operation.sessionId !== ticket.sessionId || operation.claimId !== ticket.claimId || operation.testExecutionId !== ticket.testExecutionId || (local.executionGeneration ?? ticket.executionGeneration) !== operation.executionGeneration || currentConnection && operation.executionGeneration !== fence?.executionGeneration || (operation.state !== "rejected" && operation.state !== "expired"))
+            throw new Error("Invalid dispatch refusal receipt.");
+        journal.recordOperation(operation.operationId, operation.state, null, operation.error?.message ?? "Operation no longer has current permission or state.");
+    };
+    const clearConnection = () => { fence = null; synchronized = false; reconciled = false; syncPending = false; contentRequests.length = 0; pendingBatch = null; callbacks.onConnection(false); for (const waiter of authorization.values()) {
+        clearTimeout(waiter.timer);
+        waiter.reject(new Error("Relay disconnected before native dispatch authorization."));
+    } authorization.clear(); };
+    const send = (message) => { if (!socket || socket.readyState !== WebSocket.OPEN)
+        throw new Error("Session relay is offline."); const text = JSON.stringify(message); if (sessionWireBytes(message) > RELAY_LIMITS.maxFrameBytes)
+        throw new Error("Controller frame exceeds relay limit."); socket.send(text); };
+    const prefix = () => { if (!fence)
+        throw new Error("Session relay is not synchronized."); return { protocol: SESSION_PROTOCOL, ...fence }; };
+    const sendReconciliation = () => {
+        const batch = reconciliation.shift() ?? [];
+        send({ ...prefix(), type: "reconcile", final: reconciliation.length === 0, operations: batch.map(o => ({ operationId: o.operationId, state: o.state === "accepted" ? "not_submitted" : ["confirmed", "failed", "rejected", "expired", "provider_accepted"].includes(o.state) ? o.state : "unknown", providerResult: publicOperation(ticket, o).providerResult, error: publicOperation(ticket, o).error })) });
+    };
+    const connect = async () => {
+        if (stopped || connecting || socket)
+            return;
+        connecting = true;
+        try {
+            const grant = await readControllerGrant(ticket);
+            if (stopped)
+                return;
+            currentToken = grant.token;
+            const url = new URL("/api/v1/controller-channel", ticket.serverOrigin);
+            url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+            const ws = new WebSocket(url, { headers: { Authorization: `Bearer ${grant.token}` }, handshakeTimeout: 10_000, maxPayload: RELAY_LIMITS.maxFrameBytes });
+            socket = ws;
+            ws.on("error", error => callbacks.onError(error.message));
+            ws.on("close", () => { if (socket !== ws)
+                return; socket = null; clearConnection(); reconnectAt = Date.now() + 1000; });
+            ws.on("open", () => { if (stopped || socket !== ws)
+                return; send({ type: "hello", protocol: SESSION_PROTOCOL, schemaVersion: 1, projectionVersion: 1, ...sessionFence(ticket), controllerId: ticket.controllerId, controllerInstanceId: ticket.controllerInstanceId, provider: ticket.provider, sourceEpoch: ticket.executionId, lastAckedSourceSeq: journal.getLastAcknowledgedSequence(), ...(journal.getSourceFloor ? { sourceFloor: connectionFloor = journal.getSourceFloor() } : {}) }); });
+            ws.on("message", data => {
+                if (stopped || socket !== ws)
+                    return;
+                try {
+                    const message = parseRelayMessage(JSON.parse(data.toString()));
+                    if (message.type === "welcome") {
+                        if (message.session.sessionId !== ticket.sessionId || message.session.claimId !== ticket.claimId || message.session.testExecutionId !== ticket.testExecutionId || message.session.executionGeneration !== ticket.executionGeneration || message.session.identity.controllerInstanceId !== ticket.controllerInstanceId)
+                            throw new Error("Relay identity mismatch.");
+                        fence = { ...sessionFence(ticket), connectionEpoch: message.connectionEpoch };
+                        requiresLiveSync = message.requiresLiveSync === true;
+                        historyEpoch = message.session.historyEpoch;
+                        journal.acknowledgeEvents(message.lastAckedSourceSeq);
+                        const unacknowledged = [];
+                        let after;
+                        for (;;) {
+                            const page = journal.listUnacknowledgedOperations(100, after);
+                            unacknowledged.push(...page.filter(o => o.kind !== "initial" && o.kind !== "cleanup"));
+                            if (page.length < 100)
+                                break;
+                            after = page.at(-1).operationId;
+                        }
+                        reconciliation = [];
+                        for (let i = 0; i < unacknowledged.length; i += 100)
+                            reconciliation.push(unacknowledged.slice(i, i + 100));
+                        if (!reconciliation.length)
+                            reconciliation.push([]);
+                        sendReconciliation();
+                        return;
+                    }
+                    if (!fence || message.sessionId !== fence.sessionId || message.claimId !== fence.claimId || message.testExecutionId !== fence.testExecutionId || message.executionGeneration !== fence.executionGeneration || message.connectionEpoch !== fence.connectionEpoch)
+                        throw new Error("Stale relay frame.");
+                    if (message.type === "reconcile_result") {
+                        for (const operation of message.operations)
+                            if (["confirmed", "failed", "rejected", "expired"].includes(operation.state)) {
+                                if (operation.state === "rejected" || operation.state === "expired")
+                                    settleDispatchRefusal(operation);
+                                journal.markOperationAcknowledged(operation.operationId);
+                            }
+                        if (reconciliation.length)
+                            sendReconciliation();
+                        else {
+                            reconciled = true;
+                            if (!requiresLiveSync) {
+                                synchronized = true;
+                                callbacks.onConnection(true);
+                            }
+                        }
+                    }
+                    else if (message.type === "sync_ack") {
+                        if (!requiresLiveSync || !syncPending || !reconciled)
+                            throw new Error("Unexpected live synchronization acknowledgement.");
+                        syncPending = false;
+                        synchronized = true;
+                        callbacks.onConnection(true);
+                    }
+                    else if (message.type === "content_request") {
+                        if (!synchronized || !requiresLiveSync)
+                            throw new Error("Content requested before live synchronization.");
+                        if (contentRequests.length >= 4) {
+                            send({ ...prefix(), type: "content_response", requestId: message.requestId, sourceThrough: journal.getLastAcknowledgedSequence(), result: null, error: { code: "rate_limited", message: "Local content request capacity is unavailable." } });
+                        }
+                        else
+                            contentRequests.push({ request: message, response: null });
+                    }
+                    else if (message.type === "receipt_ack") {
+                        const operation = message.operation;
+                        const waiter = authorization.get(operation.operationId);
+                        if (waiter || operation.state === "rejected" || operation.state === "expired")
+                            settleDispatchRefusal(operation, waiter !== undefined, true);
+                        journal.markOperationAcknowledged(operation.operationId);
+                        if (waiter) {
+                            authorization.delete(operation.operationId);
+                            clearTimeout(waiter.timer);
+                            waiter.reject(new Error(operation.error?.message ?? "Operation no longer has current permission or state."));
+                        }
+                    }
+                    else if (message.type === "events_ack") {
+                        if (message.sourceEpoch !== ticket.executionId || !pendingBatch || message.batchId !== pendingBatch.id || BigInt(message.lastAckedSourceSeq) < BigInt(pendingBatch.through))
+                            throw new Error("Invalid event ACK.");
+                        journal.acknowledgeEvents(message.lastAckedSourceSeq);
+                        pendingBatch = null;
+                    }
+                    else if (message.type === "operation_offer") {
+                        if (!synchronized)
+                            throw new Error("Operation offered before reconciliation.");
+                        void callbacks.onCommand(message.command).catch(error => callbacks.onError(String(error)));
+                    }
+                    else if (message.type === "operation_authorized") {
+                        const waiter = authorization.get(message.operationId);
+                        if (waiter) {
+                            authorization.delete(message.operationId);
+                            clearTimeout(waiter.timer);
+                            waiter.resolve();
+                        }
+                    }
+                    else if (message.type === "error") {
+                        callbacks.onError(`${message.code}: ${message.message}`);
+                        ws.close();
+                    }
+                }
+                catch (error) {
+                    callbacks.onError(String(error));
+                    ws.close(1008, "Invalid relay frame");
+                }
+            });
+        }
+        catch (error) {
+            callbacks.onError(String(error));
+            reconnectAt = Date.now() + 1000;
+        }
+        finally {
+            connecting = false;
+        }
+    };
+    let polling = false;
+    const tick = async () => {
+        if (stopped || polling)
+            return;
+        polling = true;
+        try {
+            if (!socket) {
+                if (Date.now() >= reconnectAt)
+                    await connect();
+                return;
+            }
+            if (!fence || !reconciled)
+                return;
+            if (journal.getSourceFloor && BigInt(journal.getSourceFloor()) > BigInt(connectionFloor)) {
+                socket.close(1000, "Local history synchronization required");
+                return;
+            }
+            if (syncPending)
+                return;
+            if (Date.now() - lastHeartbeat > 10_000) {
+                const grant = await readControllerGrant(ticket);
+                if (stopped || !socket || !fence || !reconciled)
+                    return;
+                if (grant.token !== currentToken) {
+                    socket.close(1000, "Credential renewed");
+                    return;
+                }
+                send({ ...prefix(), type: "heartbeat" });
+                lastHeartbeat = Date.now();
+            }
+            if (pendingBatch)
+                return;
+            if (requiresLiveSync && !synchronized && !journal.pendingEvents(1).length) {
+                const snapshot = journal.getSnapshot();
+                const state = callbacks.readState?.() ?? { nativeSessionId: snapshot.nativeSessionId, initialInputState: snapshot.initialInputState, synchronized: true, activity: snapshot.activity, currentTurnId: snapshot.currentTurnId, capabilities: snapshot.capabilities, ...(snapshot.controls ? { controls: snapshot.controls } : {}), ...(snapshot.turnStartedAt !== undefined ? { turnStartedAt: snapshot.turnStartedAt } : {}) };
+                send({ ...prefix(), type: "sync_state", state: { ...state, synchronized: true }, pendingInteractions: journal.pendingInteractions() });
+                syncPending = true;
+                return;
+            }
+            const request = contentRequests[0];
+            if (request && !request.response) {
+                let result = null, error = null;
+                try {
+                    if (request.request.kind === "timeline" && request.request.historyEpoch !== historyEpoch)
+                        throw new Error("Timeline cursor belongs to another connection.");
+                    result = request.request.kind === "timeline" ? journal.readTimeline(request.request) : journal.readResource(request.request.resourceId, request.request.offset, request.request.limit);
+                }
+                catch (failure) {
+                    error = { code: "content_unavailable", message: failure instanceof Error ? failure.message.slice(0, 4096) : "Local content is unavailable." };
+                }
+                request.response = { requestId: request.request.requestId, sourceThrough: journal.getLastSourceSequence(), result, error };
+            }
+            const response = request?.response;
+            if (response && BigInt(journal.getLastAcknowledgedSequence()) >= BigInt(response.sourceThrough)) {
+                // The response and its source barrier share WS ordering. Newer events
+                // remain queued until after the server has captured this page's cursor.
+                send({ ...prefix(), type: "content_response", ...response });
+                contentRequests.shift();
+                return;
+            }
+            journal.drainProjectionGap();
+            const events = [];
+            let bytes = 1024;
+            for (const row of journal.pendingEvents(RELAY_LIMITS.maxBatchEvents)) {
+                if (response && BigInt(row.sequence) > BigInt(response.sourceThrough))
+                    break;
+                const source = { ...row.payload, sourceSeq: row.sequence };
+                // Older journals may already contain a display event that could never
+                // fit the relay. Preserve its source identity and project it as history does.
+                const event = requiresLiveSync && source.kind === "timeline_upsert" ? { ...source, payload: sessionDisplayEntry(source.payload) } : source;
+                const size = sessionWireBytes(event);
+                if (size + 1024 > RELAY_LIMITS.maxFrameBytes)
+                    throw new Error("Durable controller event exceeds relay frame limit.");
+                if (bytes + size > RELAY_LIMITS.maxFrameBytes)
+                    break;
+                events.push(event);
+                bytes += size;
+            }
+            if (events.length) {
+                const id = randomUUID();
+                pendingBatch = { id, through: events.at(-1).sourceSeq };
+                send({ ...prefix(), type: "events", batchId: id, sourceEpoch: ticket.executionId, events });
+            }
+        }
+        catch (error) {
+            callbacks.onError(String(error));
+            socket?.close();
+        }
+        finally {
+            polling = false;
+        }
+    };
+    const timer = setInterval(() => { void tick(); }, 100);
+    void tick();
+    return {
+        connected: () => synchronized && fence !== null,
+        authorize: (operationId) => new Promise((resolve, reject) => {
+            if (!synchronized) {
+                reject(new Error("Session relay is offline."));
+                return;
+            }
+            const timeout = setTimeout(() => { authorization.delete(operationId); reject(new Error("Operation authorization is unknown; native was not called.")); }, 15_000);
+            authorization.set(operationId, { resolve, reject, timer: timeout });
+            try {
+                send({ ...prefix(), type: "operation_begin", operationId });
+            }
+            catch (error) {
+                clearTimeout(timeout);
+                authorization.delete(operationId);
+                reject(error);
+            }
+        }),
+        receipt: (operation) => { if (synchronized && (!operation.executionGeneration || operation.executionGeneration === ticket.executionGeneration))
+            send({ ...prefix(), type: "operation_receipt", operation: publicOperation(ticket, operation) }); },
+        async flush(timeoutMs = 5000) { const end = Date.now() + timeoutMs; while (journal.pendingEvents(1).length && Date.now() < end)
+            await new Promise(resolve => setTimeout(resolve, 50)); if (journal.pendingEvents(1).length)
+            throw new Error("Session events remain in the durable outbox."); },
+        close: () => { stopped = true; clearInterval(timer); socket?.terminate(); socket = null; clearConnection(); },
+    };
+};
+//# sourceMappingURL=relay.js.map

package/dist/commands/controller/relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.js","sourceRoot":"","sources":["../../../src/commands/controller/relay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAoE,MAAM,2BAA2B,CAAC;AAC/H,OAAO,EAAE,YAAY,EAAE,4BAA4B,EAAE,iBAAiB,EAAgK,MAAM,sCAAsC,CAAC;AAInR,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAA8B,EAAE,SAA8B,EAAoB,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,mBAAmB,EAAE,SAAS,CAAC,mBAAmB,IAAI,MAAM,CAAC,mBAAmB,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,cAAc,EAAG,SAAS,CAAC,MAAoE,EAAE,WAAW,IAAI,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACvnB,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,MAA8B,EAAoC,EAAE;IAC5G,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACpD,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,QAAQ,CAAC,cAAc,EAAE,IAAI,QAAQ,CAAC,IAAI,GAAG,MAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACzN,MAAM,KAAK,GAAG,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAY,CAAC,CAAC;IACjH,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,eAAe,KAAK,MAAM,CAAC,eAAe,IAAI,KAAK,CAAC,mBAAmB,KAAK,MAAM,CAAC,mBAAmB,IAAI,KAAK,CAAC,YAAY,KAAK,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC,oBAAoB,KAAK,MAAM,CAAC,oBAAoB,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IAC1a,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AACF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAA8B,EAAE,OAAiC,EAAE,SAAuK,EAAE,EAAE;IAClR,IAAI,MAAM,GAAqB,IAAI,EAAE,KAAK,GAA2B,IAAI,EAAE,OAAO,GAAG,KAAK,EAAE,YAAY,GAAG,KAAK,CAAC;IACjH,IAAI,UAAU,GAAG,KAAK,EAAE,gBAAgB,GAAG,KAAK,EAAE,WAAW,GAAG,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC;IAC7F,IAAI,YAAY,GAAG,EAAE,CAAC;IACtB,MAAM,eAAe,GAAoE,EAAE,CAAC;IAC5F,IAAI,cAAc,GAA4B,EAAE,CAAC;IACjD,IAAI,YAAY,GAA2C,IAAI,EAAE,YAAY,GAAG,EAAE,EAAE,aAAa,GAAG,CAAC,EAAE,WAAW,GAAG,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IAC3I,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkF,CAAC;IAChH,MAAM,qBAAqB,GAAG,CAAC,SAA2B,EAAE,QAAQ,GAAG,KAAK,EAAE,iBAAiB,GAAG,KAAK,EAAQ,EAAE;QAC/G,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC1D,IAAI,CAAC,QAAQ,IAAI,KAAK,EAAE,KAAK,KAAK,UAAU;YAAE,OAAO;QACrD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,IAAI,SAAS,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,eAAe,KAAK,MAAM,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,mBAAmB,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,SAAS,CAAC,mBAAmB,IAAI,iBAAiB,IAAI,SAAS,CAAC,mBAAmB,KAAK,KAAK,EAAE,mBAAmB,IAAI,CAAC,SAAS,CAAC,KAAK,KAAK,UAAU,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACrgB,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,IAAI,sDAAsD,CAAC,CAAC;IAC5J,CAAC,CAAC;IACF,MAAM,eAAe,GAAG,GAAG,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,MAAM,IAAI,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;QAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC,CAAC;IAAC,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACzX,MAAM,IAAI,GAAG,CAAC,OAA0B,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACnU,MAAM,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7I,MAAM,kBAAkB,GAAG,GAAG,EAAE;QAC9B,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;QAC3C,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,mBAAmB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,SAAS,EAAE,cAAc,EAAE,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,cAAc,EAAE,KAAK,EAAE,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3a,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,IAAI,OAAO,IAAI,UAAU,IAAI,MAAM;YAAE,OAAO;QAAC,UAAU,GAAG,IAAI,CAAC;QAC/D,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAAC,IAAI,OAAO;gBAAE,OAAO;YAAC,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC;YACjG,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,4BAA4B,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YAAC,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;YAClI,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,CAAC,aAAa,EAAE,CAAC,CAAC;YAAC,MAAM,GAAG,EAAE,CAAC;YACtK,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAC1D,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,MAAM,KAAK,EAAE;gBAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACxH,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,OAAO,IAAI,MAAM,KAAK,EAAE;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,kBAAkB,EAAE,OAAO,CAAC,2BAA2B,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACle,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE;gBACtB,IAAI,OAAO,IAAI,MAAM,KAAK,EAAE;oBAAE,OAAO;gBACrC,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;oBAC/D,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;wBAC/B,IAAI,OAAO,CAAC,OAAO,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,eAAe,KAAK,MAAM,CAAC,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,mBAAmB,KAAK,MAAM,CAAC,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,KAAK,MAAM,CAAC,oBAAoB;4BAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;wBACnW,KAAK,GAAG,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;wBAC9E,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,KAAK,IAAI,CAAC;wBAAC,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;wBAClG,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;wBACtD,MAAM,cAAc,GAA0B,EAAE,CAAC;wBACjD,IAAI,KAAyB,CAAC;wBAC9B,SAAS,CAAC;4BAAC,MAAM,IAAI,GAAG,OAAO,CAAC,4BAA4B,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;4BAAC,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC;4BAAC,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG;gCAAE,MAAM;4BAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,WAAW,CAAC;wBAAC,CAAC;wBACnO,cAAc,GAAG,EAAE,CAAC;wBACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,IAAI,GAAG;4BAAE,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;wBAC3G,IAAI,CAAC,cAAc,CAAC,MAAM;4BAAE,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBACpD,kBAAkB,EAAE,CAAC;wBACrB,OAAO;oBACT,CAAC;oBACD,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC,eAAe,KAAK,KAAK,CAAC,eAAe,IAAI,OAAO,CAAC,mBAAmB,KAAK,KAAK,CAAC,mBAAmB,IAAI,OAAO,CAAC,eAAe,KAAK,KAAK,CAAC,eAAe;wBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;oBACvS,IAAI,OAAO,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;wBACxC,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAU;4BAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gCACzH,IAAI,SAAS,CAAC,KAAK,KAAK,UAAU,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS;oCAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;gCACtG,OAAO,CAAC,yBAAyB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;4BAC3D,CAAC;wBACD,IAAI,cAAc,CAAC,MAAM;4BAAE,kBAAkB,EAAE,CAAC;6BAAM,CAAC;4BAAC,UAAU,GAAG,IAAI,CAAC;4BAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;gCAAC,YAAY,GAAG,IAAI,CAAC;gCAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;4BAAC,CAAC;wBAAC,CAAC;oBAC5J,CAAC;yBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;wBACvC,IAAI,CAAC,gBAAgB,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU;4BAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;wBAC1H,WAAW,GAAG,KAAK,CAAC;wBAAC,YAAY,GAAG,IAAI,CAAC;wBAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;oBACzE,CAAC;yBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;wBAC9C,IAAI,CAAC,YAAY,IAAI,CAAC,gBAAgB;4BAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;wBAC1G,IAAI,eAAe,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;4BAChC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,2BAA2B,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,gDAAgD,EAAE,EAAE,CAAC,CAAC;wBAChP,CAAC;;4BAAM,eAAe,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;oBACpE,CAAC;yBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;wBAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;wBACpC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;wBACxD,IAAI,MAAM,IAAI,SAAS,CAAC,KAAK,KAAK,UAAU,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS;4BAAE,qBAAqB,CAAC,SAAS,EAAE,MAAM,KAAK,SAAS,EAAE,IAAI,CAAC,CAAC;wBAC5I,OAAO,CAAC,yBAAyB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;wBACzD,IAAI,MAAM,EAAE,CAAC;4BACX,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;4BAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;4BACxE,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,IAAI,sDAAsD,CAAC,CAAC,CAAC;wBAC/G,CAAC;oBACH,CAAC;yBACI,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;wBAAC,IAAI,OAAO,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW,IAAI,CAAC,YAAY,IAAI,OAAO,CAAC,OAAO,KAAK,YAAY,CAAC,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC;4BAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;wBAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;wBAAC,YAAY,GAAG,IAAI,CAAC;oBAAC,CAAC;yBACtU,IAAI,OAAO,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;wBAAC,IAAI,CAAC,YAAY;4BAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;wBAAC,KAAK,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAAC,CAAC;yBACvN,IAAI,OAAO,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;wBAAC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;wBAAC,IAAI,MAAM,EAAE,CAAC;4BAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;4BAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;4BAAC,MAAM,CAAC,OAAO,EAAE,CAAC;wBAAC,CAAC;oBAAC,CAAC;yBAChN,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;wBAAC,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;wBAAC,EAAE,CAAC,KAAK,EAAE,CAAC;oBAAC,CAAC;gBAC9G,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;gBAAC,CAAC;YAC9F,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QAAC,CAAC;gBAC9E,CAAC;YAAC,UAAU,GAAG,KAAK,CAAC;QAAC,CAAC;IACjC,CAAC,CAAC;IACF,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACtB,IAAI,OAAO,IAAI,OAAO;YAAE,OAAO;QAAC,OAAO,GAAG,IAAI,CAAC;QAC/C,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,EAAE,CAAC;gBAAC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,WAAW;oBAAE,MAAM,OAAO,EAAE,CAAC;gBAAC,OAAO;YAAC,CAAC;YACxE,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU;gBAAE,OAAO;YAClC,IAAI,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,GAAG,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;gBAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,wCAAwC,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YACnK,IAAI,WAAW;gBAAE,OAAO;YACxB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,GAAG,MAAM,EAAE,CAAC;gBAAC,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;gBAAC,IAAI,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU;oBAAE,OAAO;gBAAC,IAAI,KAAK,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;oBAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;oBAAC,OAAO;gBAAC,CAAC;gBAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;gBAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAAC,CAAC;YACpT,IAAI,YAAY;gBAAE,OAAO;YACzB,IAAI,gBAAgB,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;gBAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;gBACvC,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,CAAC,eAAe,EAAE,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,aAAa,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC9Z,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;gBACvI,WAAW,GAAG,IAAI,CAAC;gBAAC,OAAO;YAC7B,CAAC;YACD,MAAM,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;YACnC,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACjC,IAAI,MAAM,GAA8B,IAAI,EAAE,KAAK,GAA6B,IAAI,CAAC;gBACrF,IAAI,CAAC;oBACH,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,KAAK,YAAY;wBAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;oBAC5J,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACzL,CAAC;gBAAC,OAAO,OAAO,EAAE,CAAC;oBAAC,KAAK,GAAG,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,+BAA+B,EAAE,CAAC;gBAAC,CAAC;gBACpK,OAAO,CAAC,QAAQ,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YAC7H,CAAC;YACD,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;YACnC,IAAI,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,2BAA2B,EAAE,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBAChG,sEAAsE;gBACtE,wEAAwE;gBACxE,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;gBAAC,eAAe,CAAC,KAAK,EAAE,CAAC;gBAAC,OAAO;YAChG,CAAC;YACD,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAkB,EAAE,CAAC;YAAC,IAAI,KAAK,GAAG,IAAI,CAAC;YACnD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC;gBACrE,IAAI,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;oBAAE,MAAM;gBAC7E,MAAM,MAAM,GAAG,EAAE,GAAI,GAAG,CAAC,OAAkB,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAiB,CAAC;gBACtF,sEAAsE;gBACtE,8EAA8E;gBAC9E,MAAM,KAAK,GAAG,gBAAgB,IAAI,MAAM,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC3I,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBACrC,IAAI,IAAI,GAAG,IAAI,GAAG,YAAY,CAAC,aAAa;oBAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;gBACrH,IAAI,KAAK,GAAG,IAAI,GAAG,YAAY,CAAC,aAAa;oBAAE,MAAM;gBACrD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAAC,KAAK,IAAI,IAAI,CAAC;YACpC,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAAC,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;gBAAC,YAAY,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,SAAS,EAAE,CAAC;gBAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;YAAC,CAAC;QACxM,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,CAAC;gBAC9D,CAAC;YAAC,OAAO,GAAG,KAAK,CAAC;QAAC,CAAC;IAC9B,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,KAAK,IAAI,EAAE,CAAC;IACZ,OAAO;QACL,SAAS,EAAE,GAAG,EAAE,CAAC,YAAY,IAAI,KAAK,KAAK,IAAI;QAC/C,SAAS,EAAE,CAAC,WAAmB,EAAiB,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACjF,IAAI,CAAC,YAAY,EAAE,CAAC;gBAAC,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YAC9E,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YAClK,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC;gBAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC,CAAC;YAAC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBAAC,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;QACjK,CAAC,CAAC;QACF,OAAO,EAAE,CAAC,SAA8B,EAAE,EAAE,GAAG,IAAI,YAAY,IAAI,CAAC,CAAC,SAAS,CAAC,mBAAmB,IAAI,SAAS,CAAC,mBAAmB,KAAK,MAAM,CAAC,mBAAmB,CAAC;YAAE,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,SAAS,EAAE,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvQ,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,IAAmB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,OAAO,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG;YAAE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC,CAAC,CAAC;QAC7S,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;KAC9G,CAAC;AACJ,CAAC,CAAC"}

package/dist/commands/controller/resume.d.ts

@@ -0,0 +1,18 @@
+import type { CliContext } from "../../cli/context.js";
+import type { SessionProvider } from "../../session/protocol.js";
+import { type ControllerLaunchTicket } from "./launch-ticket.js";
+export type ResumeLease = {
+    ticket: ControllerLaunchTicket;
+    nativeSessionId: string;
+    release(): Promise<void>;
+};
+/** Acquire one stopped local Test Session's native writer. The caller releases
+ * the lease only after proving its new controller and descendants stopped; an
+ * uncertain stop deliberately retains the lease for explicit reconciliation. */
+export declare const acquireResume: (input: {
+    provider: SessionProvider;
+    sessionId?: string;
+}, context: CliContext, config: {
+    serverUrl: string;
+    serverToken: string;
+}) => Promise<ResumeLease>;