import type {
  ResponsesRequestContext,
  ResponsesAdmissionState,
  PassthroughAdmissionState,
} from "./core-options";
import type { PreparedResponsesRequest } from "./request-prepare";
import type { ResponsesTransport } from "./request-transport";
import type { ResponsesSidecarAuth } from "./request-sidecar-auth";
import type { ResponsesEffects } from "./response-effects";
import type { ResponsesSendBudget } from "./request-send-budget";
import { preparePassthroughExchange, type PassthroughAdapterHandoff } from "./passthrough-dispatch";
import { deliverPassthroughResponse } from "./passthrough-delivery";
import { guardDirectPassthroughBodyInactivity } from "../../lib/response-body-inactivity";
import { resolveStallTimeoutMs } from "../../stall-timeout";
import { releaseUpstreamHostAdmission } from "../../codex/upstream-host-health";
import { releaseCodexAuthContextProbeLease } from "../../codex/auth-context";
import { attachResponseToolOwnership } from "./response-tool-ownership";

/** Owns the native host lease across dispatch, recovery, and response construction. */
export async function executePassthroughResponse(
  requestContext: ResponsesRequestContext,
  admissionState: ResponsesAdmissionState,
  requestState: PreparedResponsesRequest,
  transportState: ResponsesTransport,
  sidecarState: ResponsesSidecarAuth,
  responseEffects: ResponsesEffects,
  sendBudgetState: ResponsesSendBudget,
): Promise<Response | PassthroughAdapterHandoff> {
  const nativeHostState: PassthroughAdmissionState = { lease: admissionState.pendingHostAdmissionLease };
  admissionState.pendingHostAdmissionLease = null;
  try {
    const nativeExchange = await preparePassthroughExchange(
      requestContext,
      admissionState,
      nativeHostState,
      requestState,
      transportState,
      responseEffects,
      sendBudgetState,
    );
    if (nativeExchange instanceof Response || nativeExchange.kind === "adapter-handoff") return nativeExchange;
    const response = await deliverPassthroughResponse(
      requestContext,
      admissionState,
      requestState,
      transportState,
      sidecarState,
      responseEffects,
      nativeExchange,
      sendBudgetState.dispatchSidecarSend,
    );
    // Delivery has already classified SSE (including a missing upstream content type)
    // and consumed bounded JSON/errors. Guard only its remaining direct body, outside
    // the relay/lifetime wrappers so their prefetch cannot arm our inactivity clock.
    return attachResponseToolOwnership(guardDirectPassthroughBodyInactivity(
      response,
      nativeExchange.upstream.signal,
      resolveStallTimeoutMs(requestContext.config.stallTimeoutSec, { localUpstream: nativeExchange.localUpstream }),
    ), nativeExchange.providerExecutedCallTypes);
  } finally {
    if (nativeHostState.lease) {
      releaseUpstreamHostAdmission(nativeHostState.lease);
      releaseCodexAuthContextProbeLease(admissionState.authCtx);
    }
  }
}
