proxy

Documentation

Overview

Package proxy implements the drop-in HTTP proxy mode:

squoze proxy --port 8787 --upstream https://api.anthropic.com

Contract: squoze never breaks a request. If the engine panics or the body is unreadable, the original bytes go upstream unchanged (fail-open).

Index

• func New(upstream *url.URL) http.Handler
• type Server
  • func NewWithEngine(upstream *url.URL, eng *engine.Engine) *Server
  • func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request)
  • func (s *Server) WithLog(w io.Writer) *Server

Functions

func New

func New(upstream *url.URL) http.Handler

New returns an http.Handler that optimizes request bodies and forwards everything else verbatim to upstream, using the default engine.

Types

type Server

type Server struct {
	// contains filtered or unexported fields
}

Server is the squoze HTTP proxy bound to one engine instance.

func NewWithEngine

func NewWithEngine(upstream *url.URL, eng *engine.Engine) *Server

NewWithEngine binds the proxy to a specific engine (memo + originals shared across requests). A nil engine selects the package default. A nil upstream enables header-only routing: every request MUST carry X-Squoze-Upstream or gets a 502 (used by `sq <config-agent>` where each provider carries its own original endpoint).

func (*Server) ServeHTTP

func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request)

ServeHTTP implements the proxy pipeline.

func (*Server) WithLog

func (s *Server) WithLog(w io.Writer) *Server

WithLog attaches a request log sink (JSONL, one object per request).