Skip to content

Secure, Fast, and Extensible Sandbox runtime for AI agents.

3.0 KB
Raw Blame
// Copyright 2026 The OpenSandbox Authors
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package proxy

import (
	"net"
	"net/http"

	"github.com/alibaba/opensandbox/ingress/pkg/activity"
	"github.com/alibaba/opensandbox/ingress/pkg/proxy/connectivity"
	"github.com/alibaba/opensandbox/ingress/pkg/wake"
)

// Option configures optional proxy behavior without changing existing callers.
type Option func(*proxyOptions)

type proxyOptions struct {
	connectObserver           connectivity.Observer
	webSocketMessageSizeLimit int64
	activity                  activity.Recorder
	waker                     *wake.Waker
}

// WithConnectObserver observes HTTP and WebSocket TCP connection attempts.
func WithConnectObserver(observer connectivity.Observer) Option {
	return func(options *proxyOptions) {
		options.connectObserver = observer
	}
}

// WithWebSocketMessageSizeLimit sets the maximum size, in bytes, of one
// WebSocket message in either relay direction. Non-positive values are ignored
// so callers cannot accidentally disable the safety limit.
func WithWebSocketMessageSizeLimit(limit int64) Option {
	return func(options *proxyOptions) {
		if limit > 0 {
			options.webSocketMessageSizeLimit = limit
		}
	}
}

func newObservedHTTPTransport(observer connectivity.Observer) http.RoundTripper {
	if observer == nil {
		return nil
	}

	baseTransport, ok := http.DefaultTransport.(*http.Transport)
	if !ok {
		return nil
	}
	transport := baseTransport.Clone()
	baseDialContext := transport.DialContext
	if baseDialContext == nil {
		baseDialer := &net.Dialer{}
		baseDialContext = baseDialer.DialContext
	}
	transport.DialContext = connectivity.WrapDialContext(baseDialContext, observer, "http")
	return transport
}

// newObservedWebSocketHTTPClient returns the *http.Client that coder/websocket
// uses to dial backends. Its Transport's DialContext is wrapped so each TCP
// connection attempt is recorded by the connectivity observer under the
// "websocket" protocol label, matching the metrics dimensions the gorilla-based
// implementation used to emit.
func newObservedWebSocketHTTPClient(observer connectivity.Observer) *http.Client {
	if observer == nil {
		return nil
	}

	baseTransport, ok := http.DefaultTransport.(*http.Transport)
	if !ok {
		return nil
	}
	transport := baseTransport.Clone()
	baseDialContext := transport.DialContext
	if baseDialContext == nil {
		baseDialer := &net.Dialer{}
		baseDialContext = baseDialer.DialContext
	}
	transport.DialContext = connectivity.WrapDialContext(baseDialContext, observer, "websocket")
	return &http.Client{Transport: transport}
}