feat: support endpoint upload file

config.example.yaml

@@ -35,6 +35,10 @@ remote-management:
 # Authentication directory (supports ~ for home directory)
 auth-dir: "~/.cli-proxy-api"
 
+# Uploaded files directory (supports ~ for home directory).
+# Leave empty to use the default location: <auth-dir>/files
+files-dir: ""
+
 # API keys for authentication
 api-keys:
   - "your-api-key-1"

go.mod

@@ -29,6 +29,7 @@ require (
 	golang.org/x/sync v0.18.0
 	gopkg.in/natefinch/lumberjack.v2 v2.2.1
 	gopkg.in/yaml.v3 v3.0.1
+	rsc.io/pdf v0.1.1
 )
 
 require (

go.sum

@@ -241,4 +241,5 @@ gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
 nullprogram.com/x/optparse v1.0.0/go.mod h1:KdyPE+Igbe0jQUrVfMqDMeJQIJZEuyV7pjYmp6pbG50=
+rsc.io/pdf v0.1.1 h1:k1MczvYDUvJBe93bYd7wrZLLUEcLZAuF824/I4e5Xr4=
 rsc.io/pdf v0.1.1/go.mod h1:n8OzWcQ6Sp37PL01nO98y4iUCRdTGarVfzxY20ICaU4=

internal/api/modules/amp/routes.go

@@ -267,7 +267,7 @@ func (m *AmpModule) registerProviderAliases(engine *gin.Engine, baseHandler *han
 	openaiHandlers := openai.NewOpenAIAPIHandler(baseHandler)
 	geminiHandlers := gemini.NewGeminiAPIHandler(baseHandler)
 	claudeCodeHandlers := claude.NewClaudeCodeAPIHandler(baseHandler)
-	openaiResponsesHandlers := openai.NewOpenAIResponsesAPIHandler(baseHandler)
+	openaiResponsesHandlers := openai.NewOpenAIResponsesAPIHandler(baseHandler, nil)
 
 	// Create fallback handler wrapper that forwards to ampcode.com when provider not found
 	// Uses m.getProxy() for hot-reload support (proxy can be updated at runtime)

internal/api/server.go

@@ -25,6 +25,7 @@ import (
 	"github.com/router-for-me/CLIProxyAPI/v6/internal/api/modules"
 	ampmodule "github.com/router-for-me/CLIProxyAPI/v6/internal/api/modules/amp"
 	"github.com/router-for-me/CLIProxyAPI/v6/internal/config"
+	cliproxyfiles "github.com/router-for-me/CLIProxyAPI/v6/internal/files"
 	"github.com/router-for-me/CLIProxyAPI/v6/internal/logging"
 	"github.com/router-for-me/CLIProxyAPI/v6/internal/managementasset"
 	"github.com/router-for-me/CLIProxyAPI/v6/internal/usage"
@@ -322,7 +323,12 @@ func (s *Server) setupRoutes() {
 	geminiHandlers := gemini.NewGeminiAPIHandler(s.handlers)
 	geminiCLIHandlers := gemini.NewGeminiCLIAPIHandler(s.handlers)
 	claudeCodeHandlers := claude.NewClaudeCodeAPIHandler(s.handlers)
-	openaiResponsesHandlers := openai.NewOpenAIResponsesAPIHandler(s.handlers)
+	fileStore, err := cliproxyfiles.NewStoreWithDir(s.cfg.AuthDir, s.cfg.FilesDir)
+	if err != nil {
+		log.WithError(err).Warn("failed to initialize local file store")
+	}
+	openaiResponsesHandlers := openai.NewOpenAIResponsesAPIHandler(s.handlers, fileStore)
+	openaiFilesHandlers := openai.NewOpenAIFilesAPIHandler(fileStore)
 
 	// OpenAI compatible API routes
 	v1 := s.engine.Group("/v1")
@@ -333,6 +339,10 @@ func (s *Server) setupRoutes() {
 		v1.POST("/completions", openaiHandlers.Completions)
 		v1.POST("/messages", claudeCodeHandlers.ClaudeMessages)
 		v1.POST("/messages/count_tokens", claudeCodeHandlers.ClaudeCountTokens)
+		v1.GET("/files", openaiFilesHandlers.List)
+		v1.POST("/files", openaiFilesHandlers.Create)
+		v1.GET("/files/:id", openaiFilesHandlers.Get)
+		v1.DELETE("/files/:id", openaiFilesHandlers.Delete)
 		v1.GET("/responses", openaiResponsesHandlers.ResponsesWebsocket)
 		v1.POST("/responses", openaiResponsesHandlers.Responses)
 		v1.POST("/responses/compact", openaiResponsesHandlers.Compact)

internal/api/server_test.go

@@ -89,6 +89,12 @@ func TestAmpProviderModelRoutes(t *testing.T) {
 			wantStatus:   http.StatusOK,
 			wantContains: `"models"`,
 		},
+		{
+			name:         "files list",
+			path:         "/v1/files",
+			wantStatus:   http.StatusOK,
+			wantContains: `"object":"list"`,
+		},
 	}
 
 	for _, tc := range testCases {

internal/config/config.go

@@ -42,6 +42,10 @@ type Config struct {
 	// AuthDir is the directory where authentication token files are stored.
 	AuthDir string `yaml:"auth-dir" json:"-"`
 
+	// FilesDir overrides the directory where uploaded files are stored.
+	// When empty, uploads are stored under <auth-dir>/files.
+	FilesDir string `yaml:"files-dir" json:"-"`
+
 	// Debug enables or disables debug-level logging and other debug features.
 	Debug bool `yaml:"debug" json:"debug"`
 

internal/config/files_dir_test.go

@@ -0,0 +1,28 @@
+package config
+
+import (
+	"os"
+	"path/filepath"
+	"testing"
+)
+
+func TestLoadConfigOptional_FilesDir(t *testing.T) {
+	dir := t.TempDir()
+	configPath := filepath.Join(dir, "config.yaml")
+	configYAML := []byte("\nauth-dir: ~/.cli-proxy-api\nfiles-dir: ~/custom-uploads\n")
+	if err := os.WriteFile(configPath, configYAML, 0o600); err != nil {
+		t.Fatalf("failed to write config: %v", err)
+	}
+
+	cfg, err := LoadConfigOptional(configPath, false)
+	if err != nil {
+		t.Fatalf("LoadConfigOptional() error = %v", err)
+	}
+
+	if got := cfg.AuthDir; got != "~/.cli-proxy-api" {
+		t.Fatalf("AuthDir = %q, want %q", got, "~/.cli-proxy-api")
+	}
+	if got := cfg.FilesDir; got != "~/custom-uploads" {
+		t.Fatalf("FilesDir = %q, want %q", got, "~/custom-uploads")
+	}
+}