proxy

type ClaudeDesktop ¶

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

ClaudeDesktop is the local gateway that Claude Desktop reaches through its native third-party inference mode. It is deliberately an ordinary HTTP reverse proxy: Claude terminates its own gateway protocol here, so no TLS interception or system trust changes are necessary.

func NewClaudeDesktop(config ClaudeDesktopConfig) (*ClaudeDesktop, error)

func (p *ClaudeDesktop) Addr() string

func (p *ClaudeDesktop) Close(ctx context.Context) error

func (p *ClaudeDesktop) Counts() ClaudeDesktopCounts

func (p *ClaudeDesktop) Models() []ClaudeDesktopModel

func (p *ClaudeDesktop) ServeHTTP(w http.ResponseWriter, r *http.Request)

func (p *ClaudeDesktop) SetModels(models []ClaudeDesktopModel) error

func (p *ClaudeDesktop) Start() error

type ClaudeDesktopAccessReason ¶

type ClaudeDesktopAccessReason string

const (
	ClaudeDesktopAccessCloudOff                ClaudeDesktopAccessReason = "cloud_off"
	ClaudeDesktopAccessSignInRequired          ClaudeDesktopAccessReason = "sign_in_required"
	ClaudeDesktopAccessUpgradeRequired         ClaudeDesktopAccessReason = "upgrade_required"
	ClaudeDesktopAccessVerificationUnavailable ClaudeDesktopAccessReason = "verification_unavailable"
	ClaudeDesktopAccessModelNotInstalled       ClaudeDesktopAccessReason = "model_not_installed"
)

type ClaudeDesktopAccessState ¶

type ClaudeDesktopAccessState struct {
	Cloud   ClaudeDesktopCloudStatus
	Account ClaudeDesktopAccountStatus
	Plan    string
}

ClaudeDesktopAccessState is the current account and Cloud state used to evaluate Claude Desktop models. Callers should resolve it again at each user action or proxy request because both settings and account state can change.

type ClaudeDesktopAccountStatus ¶

type ClaudeDesktopAccountStatus string

const (
	ClaudeDesktopAccountUnknown   ClaudeDesktopAccountStatus = "unknown"
	ClaudeDesktopAccountSignedOut ClaudeDesktopAccountStatus = "signed_out"
	ClaudeDesktopAccountSignedIn  ClaudeDesktopAccountStatus = "signed_in"
)

type ClaudeDesktopAvailability ¶

type ClaudeDesktopAvailability string

const (
	ClaudeDesktopAvailabilityUnknown     ClaudeDesktopAvailability = "unknown"
	ClaudeDesktopAvailabilityAvailable   ClaudeDesktopAvailability = "available"
	ClaudeDesktopAvailabilityUnavailable ClaudeDesktopAvailability = "unavailable"
)

type ClaudeDesktopCloudStatus ¶

type ClaudeDesktopCloudStatus string

const (
	ClaudeDesktopCloudUnknown ClaudeDesktopCloudStatus = "unknown"
	ClaudeDesktopCloudOff     ClaudeDesktopCloudStatus = "off"
	ClaudeDesktopCloudOn      ClaudeDesktopCloudStatus = "on"
)

type ClaudeDesktopConfig ¶

type ClaudeDesktopConfig struct {
	ListenAddr         string
	OllamaURL          string
	Model              string
	Models             []ClaudeDesktopModel
	Logger             *slog.Logger
	OnCountsChanged    func(ClaudeDesktopCounts)
	RefreshModels      func(context.Context, []ClaudeDesktopModel) ([]ClaudeDesktopModel, error)
	ResolveAccessState func(context.Context) (ClaudeDesktopAccessState, error)
	ListLocalModels    func(context.Context) ([]string, error)
}

ClaudeDesktopConfig configures a Claude Desktop proxy instance.

type ClaudeDesktopCounts ¶

type ClaudeDesktopCounts struct {
	Routed uint64
}

ClaudeDesktopCounts reports requests routed through the proxy.

type ClaudeDesktopModel ¶

type ClaudeDesktopModel struct {
	Name         string
	Description  string
	DisplayName  string
	RequiredPlan string
	OllamaModel  string
	Cloud        bool
	Recommended  bool
	AccountCloud bool
	// contains filtered or unexported fields
}

ClaudeDesktopModel is one Ollama model adapted for Claude Desktop's model catalog. Name is the canonical recommendation identifier shown to users; OllamaModel is the explicit route sent to the local Ollama server.

func ClaudeDesktopModelsFromCloudInventory(names []string) []ClaudeDesktopModel

func ClaudeDesktopModelsFromRecommendations(recommendations []api.ModelRecommendation) []ClaudeDesktopModel

func DefaultClaudeDesktopModels() []ClaudeDesktopModel

func FetchClaudeDesktopModels(client *http.Client, req *http.Request) ([]ClaudeDesktopModel, error)

func MapClaudeDesktopModels(available []ClaudeDesktopModel, mappings map[string]string) []ClaudeDesktopModel

func PreserveClaudeDesktopCloudEntitlements(models, previous []ClaudeDesktopModel) []ClaudeDesktopModel

func SelectClaudeDesktopModels(available []ClaudeDesktopModel, selected []string) []ClaudeDesktopModel

func UnverifyClaudeDesktopCloudEntitlements(models []ClaudeDesktopModel) []ClaudeDesktopModel

func VerifyClaudeDesktopModelsWithCloudInventory(models, inventory []ClaudeDesktopModel) []ClaudeDesktopModel

func WithoutClaudeDesktopRecommendationMappings(models []ClaudeDesktopModel) []ClaudeDesktopModel

func (m ClaudeDesktopModel) GatewayID() string

type ClaudeDesktopModelAccess ¶

type ClaudeDesktopModelAccess struct {
	Availability ClaudeDesktopAvailability
	Reason       ClaudeDesktopAccessReason
	RequiredPlan string
}

ClaudeDesktopModelAccess is the policy decision for one model.

func EvaluateClaudeDesktopModelAccess(model ClaudeDesktopModel, state ClaudeDesktopAccessState, installed, inventoryKnown bool) ClaudeDesktopModelAccess

type ClaudeDesktopRoute ¶

type ClaudeDesktopRoute struct {
	ID          string
	DisplayName string
}

ClaudeDesktopRoute is one fixed model ID accepted by Claude Desktop. The gateway advertises the mapped Ollama model as its display name.

func ClaudeDesktopRoutes() []ClaudeDesktopRoute