Skip to content

Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.

15.6 KB
Raw Blame
package client

import (
	"context"
	"encoding/json"
	"errors"
	"fmt"
	"io"
	"net/http"
	"net/http/httptest"
	"strings"
	"testing"
	"time"
)

// agentSSEEvent serializes resp as one SSE frame — a `data:` line followed by
// the empty line that dispatches it — matching the wire shape the SDK
// streaming endpoints and processAgentSSEStream consume.
func agentSSEEvent(t *testing.T, w io.Writer, resp AgentStreamResponse) {
	t.Helper()
	b, err := json.Marshal(resp)
	if err != nil {
		t.Fatalf("marshal agent event: %v", err)
	}
	fmt.Fprintf(w, "data: %s\n\n", b)
}

func knowledgeSSEEvent(t *testing.T, w io.Writer, resp StreamResponse, eventType string) {
	t.Helper()
	b, err := json.Marshal(resp)
	if err != nil {
		t.Fatalf("marshal knowledge event: %v", err)
	}
	if eventType != "" {
		fmt.Fprintf(w, "event:%s\n", eventType)
	}
	fmt.Fprintf(w, "data:%s\n\n", b)
}

func TestProcessAgentSSEStream_MultilineDataFrame(t *testing.T) {
	frame := "data: {\"response_type\":\"answer\",\n" +
		"data: \"content\":\"hello\",\"done\":false}\n\n"

	c := &Client{}
	var got *AgentStreamResponse
	err := c.processAgentSSEStream(strings.NewReader(frame), func(resp *AgentStreamResponse) error {
		got = resp
		return nil
	})
	if err != nil {
		t.Fatalf("multiline SSE data frame failed: %v", err)
	}
	if got == nil {
		t.Fatal("callback was not invoked")
	}
	if got.ResponseType != AgentResponseTypeAnswer || got.Content != "hello" {
		t.Fatalf("response = %#v, want answer content hello", got)
	}
}

func TestKnowledgeQAStream_MultilineDataFrame(t *testing.T) {
	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
		w.Header().Set("Content-Type", "text/event-stream")
		_, _ = fmt.Fprint(w, "data:{\"response_type\":\"answer\",\n")
		_, _ = fmt.Fprint(w, "data:\"content\":\"hello\",\"done\":false}\n\n")
	}))
	defer srv.Close()

	c := NewClient(srv.URL)
	var got *StreamResponse
	err := c.KnowledgeQAStream(context.Background(), "sess", &KnowledgeQARequest{Query: "q"},
		func(e *StreamResponse) error {
			got = e
			return nil
		})
	if err != nil {
		t.Fatalf("multiline knowledge SSE data frame failed: %v", err)
	}
	if got == nil {
		t.Fatal("callback was not invoked")
	}
	if got.ResponseType != ResponseTypeAnswer || got.Content != "hello" {
		t.Fatalf("response = %#v, want answer content hello", got)
	}
}

func TestContinueStream_MultilineDataFrame(t *testing.T) {
	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
		w.Header().Set("Content-Type", "text/event-stream")
		_, _ = fmt.Fprint(w, "event:message\n")
		_, _ = fmt.Fprint(w, "data:{\"response_type\":\"answer\",\n")
		_, _ = fmt.Fprint(w, "data:\"content\":\"hello\",\"done\":false}\n\n")
	}))
	defer srv.Close()

	c := NewClient(srv.URL)
	var got *StreamResponse
	err := c.ContinueStream(context.Background(), "sess", "msg", func(e *StreamResponse) error {
		got = e
		return nil
	})
	if err != nil {
		t.Fatalf("multiline continue SSE data frame failed: %v", err)
	}
	if got == nil {
		t.Fatal("callback was not invoked")
	}
	if got.ResponseType != ResponseTypeAnswer || got.Content != "hello" {
		t.Fatalf("response = %#v, want answer content hello", got)
	}
}

func TestContinueStream_EventFieldSpace(t *testing.T) {
	cases := []struct {
		name      string
		eventType string
		wantCount int
	}{
		{"no_space", "message", 1},
		{"one_space", " message", 1},
		{"two_spaces", "  message", 0},
		{"tab", "\tmessage", 0},
		{"trailing_space", " message ", 0},
		{"other_event", " progress", 0},
	}
	for _, tc := range cases {
		t.Run(tc.name, func(t *testing.T) {
			srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
				w.Header().Set("Content-Type", "text/event-stream")
				knowledgeSSEEvent(t, w, StreamResponse{
					ResponseType: ResponseTypeAnswer,
					Content:      "hello",
				}, tc.eventType)
			}))
			defer srv.Close()

			c := NewClient(srv.URL)
			var count int
			err := c.ContinueStream(context.Background(), "sess", "msg", func(e *StreamResponse) error {
				count++
				if e.ResponseType != ResponseTypeAnswer || e.Content != "hello" {
					t.Errorf("response = %#v, want answer content hello", e)
				}
				return nil
			})
			if err != nil {
				t.Fatalf("unexpected stream error: %v", err)
			}
			if count != tc.wantCount {
				t.Errorf("callbacks = %d, want %d", count, tc.wantCount)
			}
		})
	}
}

func TestContinueStream_SpacedTerminalError(t *testing.T) {
	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
		w.Header().Set("Content-Type", "text/event-stream")
		knowledgeSSEEvent(t, w, StreamResponse{
			ResponseType: ResponseTypeError,
			Content:      "model failed",
			Done:         true,
		}, " message")
	}))
	defer srv.Close()

	c := NewClient(srv.URL)
	var count int
	err := c.ContinueStream(context.Background(), "sess", "msg", func(e *StreamResponse) error {
		count++
		if e.ResponseType != ResponseTypeError || e.Content != "model failed" || !e.Done {
			t.Errorf("response = %#v, want terminal error content model failed", e)
		}
		return nil
	})
	var streamErr *SSEStreamError
	if !errors.As(err, &streamErr) || streamErr.Content != "model failed" {
		t.Errorf("err = %v, want terminal SSE error with content model failed", err)
	}
	if count != 1 {
		t.Errorf("callbacks = %d, want 1", count)
	}
}

// emptyDataFrameStream wraps a bare `data:` frame between two real events;
// the empty frame must be skipped, not parsed as JSON.
const emptyDataFrameStream = "data:{\"response_type\":\"answer\",\"content\":\"a\"}\n\n" +
	"data:\n\n" +
	"data:{\"response_type\":\"answer\",\"content\":\"b\"}\n\n"

func TestProcessAgentSSEStream_SkipsEmptyDataFrame(t *testing.T) {
	c := &Client{}
	var got []string
	err := c.processAgentSSEStream(strings.NewReader(emptyDataFrameStream), func(resp *AgentStreamResponse) error {
		got = append(got, resp.Content)
		return nil
	})
	if err != nil {
		t.Fatalf("empty SSE data frame aborted the stream: %v", err)
	}
	if strings.Join(got, ",") != "a,b" {
		t.Fatalf("contents = %v, want [a b]", got)
	}
}

func TestKnowledgeQAStream_SkipsEmptyDataFrame(t *testing.T) {
	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
		w.Header().Set("Content-Type", "text/event-stream")
		_, _ = fmt.Fprint(w, emptyDataFrameStream)
	}))
	defer srv.Close()

	c := NewClient(srv.URL)
	var got []string
	err := c.KnowledgeQAStream(context.Background(), "sess", &KnowledgeQARequest{Query: "q"},
		func(e *StreamResponse) error {
			got = append(got, e.Content)
			return nil
		})
	if err != nil {
		t.Fatalf("empty SSE data frame aborted the stream: %v", err)
	}
	if strings.Join(got, ",") != "a,b" {
		t.Fatalf("contents = %v, want [a b]", got)
	}
}

func TestContinueStream_SkipsEmptyDataFrame(t *testing.T) {
	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
		w.Header().Set("Content-Type", "text/event-stream")
		_, _ = fmt.Fprint(w, "event:message\n"+
			strings.ReplaceAll(emptyDataFrameStream, "\n\n", "\n\nevent:message\n"))
	}))
	defer srv.Close()

	c := NewClient(srv.URL)
	var got []string
	err := c.ContinueStream(context.Background(), "sess", "msg", func(e *StreamResponse) error {
		got = append(got, e.Content)
		return nil
	})
	if err != nil {
		t.Fatalf("empty SSE data frame aborted the stream: %v", err)
	}
	if strings.Join(got, ",") != "a,b" {
		t.Fatalf("contents = %v, want [a b]", got)
	}
}

// TestProcessAgentSSEStream_DataLineLimits locks in the 4 MiB bufio.Scanner
// cap raised from the 64 KiB default: a `references` event bundling chunk
// contents reaches hundreds of KiB and previously errored "token too long".
func TestProcessAgentSSEStream_DataLineLimits(t *testing.T) {
	cases := []struct {
		name    string
		content int // bytes of Content placed in the single data line
		wantErr bool
	}{
		{"256KiB_above_old_default_parses", 256 * 1024, false},
		{"4MiB_minus_16KiB_just_under_cap_parses", 4*1024*1024 - 16*1024, false},
		{"5MiB_over_cap_errors", 5 * 1024 * 1024, true},
	}
	for _, tc := range cases {
		t.Run(tc.name, func(t *testing.T) {
			var buf strings.Builder
			agentSSEEvent(t, &buf, AgentStreamResponse{
				ResponseType: AgentResponseTypeAnswer,
				Content:      strings.Repeat("a", tc.content),
			})
			frame := buf.String()

			c := &Client{}
			var got int
			err := c.processAgentSSEStream(strings.NewReader(frame), func(*AgentStreamResponse) error {
				got++
				return nil
			})
			switch {
			case tc.wantErr && err == nil:
				t.Fatal("expected token-too-long error, got nil")
			case tc.wantErr && !strings.Contains(err.Error(), "token too long"):
				t.Errorf("err = %q, want it to contain 'token too long'", err)
			case !tc.wantErr && err != nil:
				t.Fatalf("unexpected error: %v", err)
			case !tc.wantErr && got != 1:
				t.Errorf("callbacks=%d, want 1", got)
			}
		})
	}
}

func TestKnowledgeQAStream_LargeReferenceLineParses(t *testing.T) {
	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		w.Header().Set("Content-Type", "text/event-stream")
		knowledgeSSEEvent(t, w, StreamResponse{
			ResponseType: ResponseTypeReferences,
			KnowledgeReferences: []*SearchResult{{
				ID:      "c1",
				Content: strings.Repeat("a", 256*1024),
			}},
		}, "")
	}))
	defer srv.Close()

	c := NewClient(srv.URL)
	var contentLen int
	err := c.KnowledgeQAStream(context.Background(), "sess", &KnowledgeQARequest{Query: "q"},
		func(e *StreamResponse) error {
			contentLen = len(e.KnowledgeReferences[0].Content)
			return nil
		})
	if err != nil {
		t.Fatalf("large knowledge stream event failed: %v", err)
	}
	if contentLen != 256*1024 {
		t.Errorf("content bytes=%d, want %d", contentLen, 256*1024)
	}
}

func TestContinueStream_LargeReferenceLineParses(t *testing.T) {
	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		w.Header().Set("Content-Type", "text/event-stream")
		knowledgeSSEEvent(t, w, StreamResponse{
			ResponseType: ResponseTypeReferences,
			KnowledgeReferences: []*SearchResult{{
				ID:      "c1",
				Content: strings.Repeat("a", 256*1024),
			}},
		}, "message")
	}))
	defer srv.Close()

	c := NewClient(srv.URL)
	var contentLen int
	err := c.ContinueStream(context.Background(), "sess", "msg", func(e *StreamResponse) error {
		contentLen = len(e.KnowledgeReferences[0].Content)
		return nil
	})
	if err != nil {
		t.Fatalf("large continue-stream event failed: %v", err)
	}
	if contentLen != 256*1024 {
		t.Errorf("content bytes=%d, want %d", contentLen, 256*1024)
	}
}

// TestAgentQAStreamWithRequest_DefaultBlanketTimeoutDoesNotCutStream is the
// regression test for doRequestStream: the client's ordinary default Timeout
// must NOT apply to SSE streams. Shrink that default to 100ms in-package so the
// test remains fast; the server completes at 300ms.
func TestAgentQAStreamWithRequest_DefaultBlanketTimeoutDoesNotCutStream(t *testing.T) {
	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		w.Header().Set("Content-Type", "text/event-stream")
		time.Sleep(300 * time.Millisecond)
		agentSSEEvent(t, w, AgentStreamResponse{ResponseType: AgentResponseTypeComplete, Done: true})
	}))
	defer srv.Close()

	c := NewClient(srv.URL)
	c.httpClient.Timeout = 100 * time.Millisecond // simulate a short ordinary-request default
	var gotComplete bool
	err := c.AgentQAStreamWithRequest(context.Background(), "sess",
		&AgentQARequest{Query: "q", AgentEnabled: true},
		func(e *AgentStreamResponse) error {
			if e.ResponseType == AgentResponseTypeComplete {
				gotComplete = true
			}
			return nil
		})
	if err != nil {
		t.Fatalf("stream cut by blanket timeout: %v", err)
	}
	if !gotComplete {
		t.Error("complete event never arrived")
	}
}

// TestAgentQAStreamWithRequest_ExplicitTimeoutStillApplies preserves the
// public WithTimeout contract: callers that explicitly request an upper bound
// get it for streaming calls as well as ordinary requests.
func TestAgentQAStreamWithRequest_ExplicitTimeoutStillApplies(t *testing.T) {
	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		w.Header().Set("Content-Type", "text/event-stream")
		time.Sleep(300 * time.Millisecond)
		agentSSEEvent(t, w, AgentStreamResponse{ResponseType: AgentResponseTypeComplete, Done: true})
	}))
	defer srv.Close()

	c := NewClient(srv.URL, WithTimeout(100*time.Millisecond))
	err := c.AgentQAStreamWithRequest(context.Background(), "sess",
		&AgentQARequest{Query: "q", AgentEnabled: true},
		func(*AgentStreamResponse) error { return nil })
	if err == nil {
		t.Fatal("expected explicit WithTimeout to stop the stream")
	}
	if !errors.Is(err, context.DeadlineExceeded) && !strings.Contains(err.Error(), "Client.Timeout") {
		t.Errorf("err = %v, want a client-timeout error", err)
	}
}

// TestAgentQAStreamWithRequest_TerminalErrorEndsStream verifies that a
// response_type=error, done=true frame terminates the SDK call even when the
// server leaves the HTTP connection open and never sends `complete` or EOF.
func TestAgentQAStreamWithRequest_TerminalErrorEndsStream(t *testing.T) {
	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		flusher, _ := w.(http.Flusher)
		w.Header().Set("Content-Type", "text/event-stream")
		agentSSEEvent(t, w, AgentStreamResponse{ResponseType: AgentResponseTypeError, Content: "boom", Done: true})
		if flusher != nil {
			flusher.Flush()
		}
		<-r.Context().Done() // hold open until the client disconnects
	}))
	defer srv.Close()

	c := NewClient(srv.URL)
	var got int
	start := time.Now()
	err := c.AgentQAStreamWithRequest(context.Background(), "sess",
		&AgentQARequest{Query: "q", AgentEnabled: true},
		func(*AgentStreamResponse) error {
			got++
			return nil
		})
	elapsed := time.Since(start)

	if err == nil {
		t.Fatal("expected terminal SSE error, got nil")
	}
	if !strings.Contains(err.Error(), "SSE stream error: boom") {
		t.Errorf("err = %v, want terminal SSE error", err)
	}
	if elapsed > time.Second {
		t.Errorf("stream hung: elapsed=%v", elapsed)
	}
	if got != 1 {
		t.Errorf("callbacks=%d, want 1 (error event delivered before return)", got)
	}
}

func TestKnowledgeQAStream_TerminalErrorEndsStream(t *testing.T) {
	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		flusher, _ := w.(http.Flusher)
		w.Header().Set("Content-Type", "text/event-stream")
		knowledgeSSEEvent(t, w, StreamResponse{
			ResponseType: ResponseTypeError,
			Content:      "boom",
			Done:         true,
		}, "")
		if flusher != nil {
			flusher.Flush()
		}
		<-r.Context().Done()
	}))
	defer srv.Close()

	c := NewClient(srv.URL)
	var got int
	start := time.Now()
	err := c.KnowledgeQAStream(context.Background(), "sess", &KnowledgeQARequest{Query: "q"},
		func(*StreamResponse) error {
			got++
			return nil
		})
	if err == nil || !strings.Contains(err.Error(), "SSE stream error: boom") {
		t.Fatalf("err = %v, want terminal SSE error", err)
	}
	if elapsed := time.Since(start); elapsed > time.Second {
		t.Errorf("stream hung: elapsed=%v", elapsed)
	}
	if got != 1 {
		t.Errorf("callbacks=%d, want 1", got)
	}
}

// TestSearchResult_DecodesReferenceIndexes guards the KB and chunk-hierarchy
// fields used by the CLI's bounded reference projection.
func TestSearchResult_DecodesReferenceIndexes(t *testing.T) {
	raw := `{"id":"c1","knowledge_base_id":"kb1","parent_chunk_id":"p1","sub_chunk_id":["s1","s2"],"content":"x"}`
	var r SearchResult
	if err := json.Unmarshal([]byte(raw), &r); err != nil {
		t.Fatalf("unmarshal: %v", err)
	}
	if r.ParentChunkID != "p1" {
		t.Errorf("ParentChunkID=%q, want p1", r.ParentChunkID)
	}
	if r.KnowledgeBaseID != "kb1" {
		t.Errorf("KnowledgeBaseID=%q, want kb1", r.KnowledgeBaseID)
	}
	if len(r.SubChunkID) != 2 || r.SubChunkID[0] != "s1" || r.SubChunkID[1] != "s2" {
		t.Errorf("SubChunkID=%v, want [s1 s2]", r.SubChunkID)
	}
}