feat: add server URL and token options

If the server URL has a path, then the SDK will implicitly disable the
server since the local SDK server cannot have a path.

Signed-off-by: Donnie Adams <[email protected]>

Author: thedadams

gptscript.go

@@ -10,6 +10,7 @@ import (
 	"fmt"
 	"io"
 	"log/slog"
+	"net/url"
 	"os"
 	"os/exec"
 	"path/filepath"
@@ -28,7 +29,6 @@ var (
 const relativeToBinaryPath = "<me>"
 
 type GPTScript struct {
-	url        string
 	globalOpts GlobalOptions
 }
 
@@ -38,10 +38,11 @@ func NewGPTScript(opts ...GlobalOptions) (*GPTScript, error) {
 	defer lock.Unlock()
 	gptscriptCount++
 
-	disableServer := os.Getenv("GPTSCRIPT_DISABLE_SERVER") == "true"
-
 	if serverURL == "" {
-		serverURL = os.Getenv("GPTSCRIPT_URL")
+		serverURL = opt.URL
+		if serverURL == "" {
+			serverURL = os.Getenv("GPTSCRIPT_URL")
+		}
 	}
 
 	if opt.Env == nil {
@@ -50,7 +51,23 @@ func NewGPTScript(opts ...GlobalOptions) (*GPTScript, error) {
 
 	opt.Env = append(opt.Env, opt.toEnv()...)
 
-	if serverProcessCancel == nil && !disableServer {
+	if serverProcessCancel == nil && os.Getenv("GPTSCRIPT_DISABLE_SERVER") != "true" {
+		if serverURL != "" {
+			u, err := url.Parse(serverURL)
+			if err != nil {
+				return nil, fmt.Errorf("failed to parse server URL: %w", err)
+			}
+
+			// If the server URL has a path, then this implies that the server is already running.
+			// In that case, we don't need to start the server.
+			if u.Path != "" && u.Path != "/" {
+				opt.URL = "http://" + serverURL
+				return &GPTScript{
+					globalOpts: opt,
+				}, nil
+			}
+		}
+
 		ctx, cancel := context.WithCancel(context.Background())
 		in, _ := io.Pipe()
 
@@ -95,12 +112,11 @@ func NewGPTScript(opts ...GlobalOptions) (*GPTScript, error) {
 
 		serverURL = strings.TrimSpace(serverURL)
 	}
-	g := &GPTScript{
-		url:        "http://" + serverURL,
-		globalOpts: opt,
-	}
 
-	return g, nil
+	opt.URL = "http://" + serverURL
+	return &GPTScript{
+		globalOpts: opt,
+	}, nil
 }
 
 func readAddress(stdErr io.Reader) (string, error) {
@@ -131,7 +147,8 @@ func (g *GPTScript) Close() {
 func (g *GPTScript) Evaluate(ctx context.Context, opts Options, tools ...ToolDef) (*Run, error) {
 	opts.GlobalOptions = completeGlobalOptions(g.globalOpts, opts.GlobalOptions)
 	return (&Run{
-		url:         g.url,
+		url:         opts.URL,
+		token:       opts.Token,
 		requestPath: "evaluate",
 		state:       Creating,
 		opts:        opts,
@@ -142,7 +159,8 @@ func (g *GPTScript) Evaluate(ctx context.Context, opts Options, tools ...ToolDef
 func (g *GPTScript) Run(ctx context.Context, toolPath string, opts Options) (*Run, error) {
 	opts.GlobalOptions = completeGlobalOptions(g.globalOpts, opts.GlobalOptions)
 	return (&Run{
-		url:         g.url,
+		url:         opts.URL,
+		token:       opts.Token,
 		requestPath: "run",
 		state:       Creating,
 		opts:        opts,
@@ -319,7 +337,7 @@ func (g *GPTScript) PromptResponse(ctx context.Context, resp PromptResponse) err
 
 func (g *GPTScript) runBasicCommand(ctx context.Context, requestPath string, body any) (string, error) {
 	run := &Run{
-		url:          g.url,
+		url:          g.globalOpts.URL,
 		requestPath:  requestPath,
 		state:        Creating,
 		basicCommand: true,

opts.go

@@ -3,6 +3,8 @@ package gptscript
 // GlobalOptions allows specification of settings that are used for every call made.
 // These options can be overridden by the corresponding Options.
 type GlobalOptions struct {
+	URL                  string   `json:"url"`
+	Token                string   `json:"token"`
 	OpenAIAPIKey         string   `json:"APIKey"`
 	OpenAIBaseURL        string   `json:"BaseURL"`
 	DefaultModel         string   `json:"DefaultModel"`
@@ -31,6 +33,8 @@ func (g GlobalOptions) toEnv() []string {
 func completeGlobalOptions(opts ...GlobalOptions) GlobalOptions {
 	var result GlobalOptions
 	for _, opt := range opts {
+		result.URL = firstSet(opt.URL, result.URL)
+		result.Token = firstSet(opt.Token, result.Token)
 		result.OpenAIAPIKey = firstSet(opt.OpenAIAPIKey, result.OpenAIAPIKey)
 		result.OpenAIBaseURL = firstSet(opt.OpenAIBaseURL, result.OpenAIBaseURL)
 		result.DefaultModel = firstSet(opt.DefaultModel, result.DefaultModel)

run.go

@@ -18,15 +18,15 @@ import (
 var errAbortRun = errors.New("run aborted")
 
 type Run struct {
-	url, requestPath, toolPath string
-	tools                      []ToolDef
-	opts                       Options
-	state                      RunState
-	chatState                  string
-	cancel                     context.CancelCauseFunc
-	err                        error
-	wait                       func()
-	basicCommand               bool
+	url, token, requestPath, toolPath string
+	tools                             []ToolDef
+	opts                              Options
+	state                             RunState
+	chatState                         string
+	cancel                            context.CancelCauseFunc
+	err                               error
+	wait                              func()
+	basicCommand                      bool
 
 	program           *Program
 	callsLock         sync.RWMutex
@@ -175,18 +175,24 @@ func (r *Run) NextChat(ctx context.Context, input string) (*Run, error) {
 		run.opts.ChatState = r.chatState
 	}
 
-	var payload any
+	var (
+		payload any
+		options = run.opts
+	)
+	// Remove the url and token because they shouldn't be sent with the payload.
+	options.URL = ""
+	options.Token = ""
 	if len(r.tools) != 0 {
 		payload = requestPayload{
 			ToolDefs: r.tools,
 			Input:    input,
-			Options:  run.opts,
+			Options:  options,
 		}
 	} else if run.toolPath != "" {
 		payload = requestPayload{
 			File:    run.toolPath,
 			Input:   input,
-			Options: run.opts,
+			Options: options,
 		}
 	}
 
@@ -228,6 +234,10 @@ func (r *Run) request(ctx context.Context, payload any) (err error) {
 		return r.err
 	}
 
+	if r.opts.Token != "" {
+		req.Header.Set("Authorization", "Bearer "+r.opts.Token)
+	}
+
 	resp, err := http.DefaultClient.Do(req)
 	if err != nil {
 		r.state = Error