Skip to content

Get up and running with Kimi, GLM, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other models.

35.7 KB
Raw Blame
package openai

import (
	"bytes"
	"encoding/json"
	"fmt"
	"slices"
	"strings"
	"testing"

	"github.com/ollama/ollama/api"
)

func TestCompactionTrimPreservesProtectedState(t *testing.T) {
	body := []byte(`{"model":"test","input":[
		{"type":"message","role":"system","content":"system instructions"},
		{"type":"message","role":"developer","content":"developer instructions"},
		{"type":"message","role":"user","content":"original goal"},
		{"type":"tool_search_call","call_id":"old","arguments":{"query":"find a tool"}},
		{"type":"tool_search_output","call_id":"old","tools":[{"type":"namespace","name":"example","tools":[{"type":"function","name":"shell","description":"` + strings.Repeat("old output ", 1000) + `","parameters":{"type":"object"}}]}]},
		{"type":"message","role":"assistant","content":"old result processed"},
		{"type":"message","role":"user","content":"latest request"},
		{"type":"function_call","call_id":"pending","name":"shell","arguments":"{}"},
		{"type":"function_call","call_id":"latest","name":"read_image","arguments":"{}"},
		{"type":"function_call_output","call_id":"latest","output":[{"type":"input_image","image_url":"` + compactionTestPNG + `"}]}
	]}`)
	plan, err := PrepareStandaloneCompaction(body)
	if err != nil {
		t.Fatal(err)
	}
	if removed := plan.TrimForContextLimit(); removed != 2 {
		t.Fatalf("removed %d items, want the old call/result pair", removed)
	}
	var refs []string
	for _, item := range plan.items {
		refs = append(refs, item.Ref)
	}
	want := []string{"item_000001", "item_000002", "item_000003", "item_000006", "item_000007", "item_000008", "item_000009", "item_000010"}
	if !slices.Equal(refs, want) {
		t.Fatalf("remaining references = %v, want %v", refs, want)
	}
	request, err := plan.SummaryRequest("")
	if err != nil {
		t.Fatal(err)
	}
	for _, marker := range []string{"system instructions", "developer instructions", "original goal", "latest request", compactionTestPNG, "2 older transcript items were omitted"} {
		if !bytes.Contains(request, []byte(marker)) {
			t.Errorf("retry prompt missing %q", marker)
		}
	}
	if bytes.Contains(request, []byte("old output")) {
		t.Fatal("old tool output remains in retry prompt")
	}
	result, err := plan.Complete(compactionResponseBody(t, map[string]any{
		"summary": "Continue the task.", "retain_item_ids": []string{},
	}))
	if err != nil {
		t.Fatal(err)
	}
	payload := decodeResultPayload(t, result)
	if !strings.Contains(payload.Summary, "2 older transcript items were omitted") {
		t.Fatal("summary does not disclose omitted history")
	}
	if len(payload.Retained) != 3 || payload.Retained[0].ToolCalls[0].ID != "pending" || payload.Retained[1].ToolCalls[0].ID != "latest" || len(payload.Retained[2].Images) != 1 {
		t.Fatalf("active tool state changed: %+v", payload.Retained)
	}
	if _, err := plan.Complete(compactionResponseBody(t, map[string]any{
		"summary": "invalid selection", "retain_item_ids": []string{"item_000004"},
	})); err == nil {
		t.Fatal("accepted a reference removed before summarization")
	}
}

func TestCompactionTrimPreservesPriorSummaryAndLatestItem(t *testing.T) {
	old, err := json.Marshal(OllamaCompactionPayload{
		Type: OllamaCompactionPayloadType, Version: OllamaCompactionPayloadVersion, Summary: "prior summary",
	})
	if err != nil {
		t.Fatal(err)
	}
	body, err := json.Marshal(map[string]any{
		"model": "test", "input": []any{
			ResponsesCompactionItem{Type: "compaction", EncryptedContent: string(old)},
			map[string]any{"type": "message", "role": "user", "content": "user request"},
			map[string]any{"type": "message", "role": "assistant", "content": strings.Repeat("older assistant text ", 500)},
			map[string]any{"type": "message", "role": "assistant", "content": "latest assistant text"},
		},
	})
	if err != nil {
		t.Fatal(err)
	}
	plan, err := PrepareStandaloneCompaction(body)
	if err != nil {
		t.Fatal(err)
	}
	if removed := plan.TrimForContextLimit(); removed != 1 {
		t.Fatalf("removed=%d, want 1", removed)
	}
	request, err := plan.SummaryRequest("")
	if err != nil {
		t.Fatal(err)
	}
	for _, marker := range []string{"prior summary", "user request", "latest assistant text"} {
		if !bytes.Contains(request, []byte(marker)) {
			t.Errorf("retry prompt missing %q", marker)
		}
	}
	if removed := plan.TrimForContextLimit(); removed != 0 {
		t.Fatalf("removed %d protected items", removed)
	}
}

func TestCompactionTrimKeepsToolPairsAcrossInterleavedResults(t *testing.T) {
	plan, err := PrepareStandaloneCompaction([]byte(`{"model":"test","input":[
		{"type":"function_call","call_id":"a","name":"shell","arguments":"{}"},
		{"type":"function_call","call_id":"b","name":"shell","arguments":"{}"},
		{"type":"function_call_output","call_id":"b","output":"b output"},
		{"type":"function_call_output","call_id":"a","output":"` + strings.Repeat("a output ", 1000) + `"},
		{"type":"message","role":"assistant","content":"processed both results"}
	]}`))
	if err != nil {
		t.Fatal(err)
	}
	if removed := plan.TrimForContextLimit(); removed != 2 {
		t.Fatalf("removed=%d, want 2", removed)
	}
	if len(plan.items) != 3 || plan.items[0].Message.ToolCalls[0].ID != "b" || plan.items[1].Message.ToolCallID != "b" {
		t.Fatal("did not preserve the other complete tool pair")
	}
	if _, _, err := analyzeCompactionToolState(plan.items); err != nil {
		t.Fatalf("trim left invalid tool state: %v", err)
	}
}

func TestCompactionPreservesStandaloneOutputs(t *testing.T) {
	body := []byte(`{"model":"test","input":[
		{"type":"message","role":"user","content":"Continue the task."},
		{"type":"function_call_output","name":"handoff","namespace":"workspace.tools","output":[
			{"type":"input_text","text":"Keep the original task instructions."},
			{"type":"input_image","image_url":"` + compactionTestPNG + `"}
		]},
		{"type":"function_call_output","call_id":null,"name":"tool_search","output":"A standalone function can have this name."},
		{"type":"message","role":"assistant","content":"` + strings.Repeat("old reasoning ", 1000) + `"},
		{"type":"message","role":"user","content":"Latest request."}
	]}`)
	plan, err := PrepareStandaloneCompaction(body)
	if err != nil {
		t.Fatal(err)
	}
	if removed := plan.TrimForContextLimit(); removed != 1 {
		t.Fatalf("removed %d items, want only the old assistant message", removed)
	}
	request, err := plan.SummaryRequest("")
	if err != nil {
		t.Fatal(err)
	}
	for _, marker := range []string{"Keep the original task instructions.", "workspace.tools", "handoff", compactionTestPNG} {
		if !bytes.Contains(request, []byte(marker)) {
			t.Errorf("summary request lost %q", marker)
		}
	}
	for cycle := range 2 {
		result, err := plan.Complete(compactionResponseBody(t, map[string]any{
			"summary": "Continue the work.", "retain_item_ids": []string{},
		}))
		if err != nil {
			t.Fatal(err)
		}
		payload := decodeResultPayload(t, result)
		if len(payload.Retained) != 2 {
			t.Fatalf("cycle %d: retained %d messages, want both standalone outputs", cycle, len(payload.Retained))
		}
		handoff, search := payload.Retained[0], payload.Retained[1]
		if handoff.ToolName != "workspace.tools.handoff" || handoff.Content != "Keep the original task instructions." || len(handoff.Images) != 1 {
			t.Fatalf("cycle %d: handoff changed: %+v", cycle, handoff)
		}
		if search.ToolName != "tool_search" || search.Content != "A standalone function can have this name." {
			t.Fatalf("cycle %d: standalone tool_search changed: %+v", cycle, search)
		}
		replay, err := json.Marshal(map[string]any{"model": "test", "input": []any{result.Item}})
		if err != nil {
			t.Fatal(err)
		}
		expanded, changed, err := ExpandResponsesCompactionInput(replay)
		if err != nil || !changed {
			t.Fatalf("cycle %d: changed=%v err=%v", cycle, changed, err)
		}
		var decoded ResponsesRequest
		if err := json.Unmarshal(expanded, &decoded); err != nil {
			t.Fatal(err)
		}
		if len(decoded.Input.Items) != 4 {
			t.Fatalf("cycle %d: want summary pair and two standalone outputs, got %d items", cycle, len(decoded.Input.Items))
		}
		for i, want := range []api.Message{handoff, search} {
			output, ok := decoded.Input.Items[i+2].(ResponsesFunctionCallOutput)
			name := payload.StandaloneNames[i]
			if !ok || output.CallID != "" || output.Name != name.Name || output.Namespace != name.Namespace || output.Output != want.Content {
				t.Fatalf("cycle %d: standalone output %d lost identity or gained a call: %+v", cycle, i, decoded.Input.Items[i+2])
			}
		}
		chat, err := FromResponsesRequest(decoded)
		if err != nil {
			t.Fatal(err)
		}
		if len(chat.Messages) != 4 || chat.Messages[2].ToolName != "workspace.tools.handoff" || !bytes.Equal(chat.Messages[2].Images[0], handoff.Images[0]) {
			t.Fatalf("cycle %d: replay changed standalone content or images: %+v", cycle, chat.Messages)
		}
		plan, err = PrepareStandaloneCompaction(expanded)
		if err != nil {
			t.Fatalf("cycle %d: cannot compact replay: %v", cycle, err)
		}
	}
}

func TestCompactionStandaloneOutputsDoNotRelaxPairing(t *testing.T) {
	for _, item := range []string{
		`{"type":"function_call_output","name":"handoff","call_id":"missing","output":"unmatched"}`,
		`{"type":"tool_search_output","tools":[]}`,
		`{"type":"tool_search_output","call_id":null,"tools":[]}`,
		`{"type":"function_call_output","name":"handoff","call_id":"","output":"empty ID"}`,
		`{"type":"function_call_output","output":"anonymous"}`,
	} {
		t.Run(item, func(t *testing.T) {
			if _, err := PrepareStandaloneCompaction([]byte(`{"model":"test","input":[` + item + `]}`)); err == nil {
				t.Fatal("accepted invalid or unmatched output")
			}
		})
	}
	// A name on a result with a call ID does not turn it into a standalone output.
	plan, err := PrepareStandaloneCompaction([]byte(`{"model":"test","input":[
		{"type":"function_call","call_id":"paired","name":"read","arguments":"{}"},
		{"type":"function_call_output","call_id":"paired","name":"read","output":"ok"},
		{"type":"message","role":"assistant","content":"Read completed."}
	]}`))
	if err != nil {
		t.Fatal(err)
	}
	result, err := plan.Complete(compactionResponseBody(t, map[string]any{
		"summary": "Finished reading.", "retain_item_ids": []string{},
	}))
	if err != nil {
		t.Fatal(err)
	}
	if retained := decodeResultPayload(t, result).Retained; len(retained) != 0 {
		t.Fatalf("completed pair was forced as standalone state: %+v", retained)
	}
}

func compactionResponseBody(t *testing.T, selection map[string]any) []byte {
	t.Helper()
	arguments, err := json.Marshal(selection)
	if err != nil {
		t.Fatal(err)
	}
	body, err := json.Marshal(map[string]any{
		"id":     "resp_summary",
		"object": "response",
		"status": "completed",
		"output": []any{map[string]any{
			"id": "fc_summary", "type": "function_call", "status": "completed",
			"call_id": "call_summary", "name": CreateSummaryToolName, "arguments": string(arguments),
		}},
		"usage": map[string]any{"input_tokens": 100, "output_tokens": 20, "total_tokens": 120},
	})
	if err != nil {
		t.Fatal(err)
	}
	return body
}

func decodeResultPayload(t *testing.T, result ResponsesCompactionResult) OllamaCompactionPayload {
	t.Helper()
	item, err := json.Marshal(result.Item)
	if err != nil {
		t.Fatal(err)
	}
	payload, err := decodeOllamaCompactionItem(item)
	if err != nil {
		t.Fatal(err)
	}
	return payload
}

func summaryTranscriptText(t *testing.T, requestBody []byte) string {
	t.Helper()
	var request struct {
		Input []struct {
			Content json.RawMessage `json:"content"`
		} `json:"input"`
	}
	if err := json.Unmarshal(requestBody, &request); err != nil {
		t.Fatal(err)
	}
	var transcript strings.Builder
	for _, input := range request.Input[1:] {
		var text string
		if json.Unmarshal(input.Content, &text) == nil {
			transcript.WriteString(text)
			continue
		}
		var blocks []struct {
			Text string `json:"text"`
		}
		if err := json.Unmarshal(input.Content, &blocks); err != nil {
			t.Fatal(err)
		}
		for _, block := range blocks {
			transcript.WriteString(block.Text)
		}
	}
	return transcript.String()
}

func TestPrepareTriggeredCompactionBuildsSummaryRequest(t *testing.T) {
	description := "Read a file"
	body := []byte(`{
		"model":"qwen3:4b",
		"stream":true,
		"instructions":"do not send this to the compactor",
		"tools":[{"type":"function","name":"read_file","description":"Read a file","strict":false,"parameters":{"type":"object"}}],
		"input":[
			{"type":"message","role":"user","content":"inspect main.go"},
			{"type":"function_call","call_id":"call_1","name":"read_file","arguments":"{\"path\":\"main.go\"}"},
			{"type":"function_call_output","call_id":"call_1","output":"package main"},
			{"type":"compaction_trigger"}
		]
	}`)

	plan, requested, err := PrepareTriggeredCompaction(body)
	if err != nil {
		t.Fatal(err)
	}
	if !requested {
		t.Fatal("expected compaction request")
	}
	if plan.Model != "qwen3:4b" || !plan.Stream {
		t.Fatalf("unexpected plan: model=%q stream=%v", plan.Model, plan.Stream)
	}

	requestBody, err := plan.SummaryRequest("")
	if err != nil {
		t.Fatal(err)
	}
	var request struct {
		Input []struct {
			Role string `json:"role"`
		} `json:"input"`
		Tools        []ResponsesTool `json:"tools"`
		Instructions string          `json:"instructions"`
		Stream       bool            `json:"stream"`
	}
	if err := json.Unmarshal(requestBody, &request); err != nil {
		t.Fatal(err)
	}
	if request.Stream {
		t.Fatal("summary inference must be non-streaming")
	}
	if request.Instructions != "" {
		t.Fatalf("original instructions leaked into summary request: %q", request.Instructions)
	}
	if len(request.Tools) != 1 || request.Tools[0].Name != CreateSummaryToolName {
		t.Fatalf("unexpected callable tools: %+v", request.Tools)
	}
	transcript := summaryTranscriptText(t, requestBody)
	if len(request.Input) != 5 || !strings.Contains(transcript, description) || !strings.Contains(transcript, "read_file") {
		t.Fatalf("summary transcript is missing tool metadata: %+v", request.Input)
	}
	if strings.Contains(transcript, `"instructions"`) {
		t.Fatalf("original instructions leaked into transcript: %s", transcript)
	}

	result, err := plan.Complete(compactionResponseBody(t, map[string]any{
		"summary": "Continue inspecting main.go.", "retain_item_ids": []string{},
	}))
	if err != nil {
		t.Fatal(err)
	}
	payload := decodeResultPayload(t, result)
	if payload.Summary != "Continue inspecting main.go." {
		t.Fatalf("unexpected summary: %q", payload.Summary)
	}
	if len(payload.Retained) != 2 {
		t.Fatalf("expected active call and result to be forced, got %+v", payload.Retained)
	}
	if payload.Retained[0].ToolCalls[0].ID != "call_1" || payload.Retained[1].ToolCallID != "call_1" {
		t.Fatalf("tool state was not retained in order: %+v", payload.Retained)
	}
}

func TestCompactionNamesBuiltInSearchToolMetadata(t *testing.T) {
	body := []byte(`{
		"model":"test",
		"stream":true,
		"tools":[{"type":"tool_search"},{"type":"web_search"}],
		"input":[
			{"type":"message","role":"user","content":"find current information"},
			{"type":"compaction_trigger"}
		]
	}`)
	plan, requested, err := PrepareTriggeredCompaction(body)
	if err != nil || !requested {
		t.Fatalf("prepare: requested=%v err=%v", requested, err)
	}

	requestBody, err := plan.SummaryRequest("")
	if err != nil {
		t.Fatal(err)
	}
	transcript := summaryTranscriptText(t, requestBody)
	if !strings.Contains(transcript, `"name":"tool_search"`) ||
		!strings.Contains(transcript, `"name":"web_search"`) {
		t.Fatalf("summary transcript is missing built-in tool names: %s", requestBody)
	}
	if strings.Contains(transcript, `"name":""`) {
		t.Fatalf("summary transcript contains unnamed tool metadata: %s", requestBody)
	}
}

const compactionTestPNG = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII="

func TestCompactionSendsImagesAsMultimodalInput(t *testing.T) {
	body := []byte(`{
		"model":"test","stream":true,
		"input":[
			{"type":"message","role":"user","content":[
				{"type":"input_text","text":"describe this"},
				{"type":"input_image","detail":"auto","image_url":"` + compactionTestPNG + `"}
			]},
			{"type":"compaction_trigger"}
		]
	}`)
	plan, requested, err := PrepareTriggeredCompaction(body)
	if err != nil || !requested {
		t.Fatalf("prepare: requested=%v err=%v", requested, err)
	}

	requestBody, err := plan.SummaryRequest("")
	if err != nil {
		t.Fatal(err)
	}
	var request struct {
		Input []struct {
			Content json.RawMessage `json:"content"`
		} `json:"input"`
	}
	if err := json.Unmarshal(requestBody, &request); err != nil {
		t.Fatal(err)
	}
	if len(request.Input) != 2 {
		t.Fatalf("input count=%d, want 2", len(request.Input))
	}
	var blocks []struct {
		Type     string `json:"type"`
		Text     string `json:"text"`
		ImageURL string `json:"image_url"`
	}
	if err := json.Unmarshal(request.Input[1].Content, &blocks); err != nil {
		t.Fatal(err)
	}
	if len(blocks) != 2 || blocks[0].Type != "input_text" || blocks[1].Type != "input_image" {
		t.Fatalf("unexpected transcript blocks: %+v", blocks)
	}
	if !strings.Contains(blocks[0].Text, `"ref":"item_000001"`) || !strings.Contains(blocks[0].Text, `"image_count":1`) {
		t.Fatalf("image is not associated with its source item: %s", blocks[0].Text)
	}
	if strings.Contains(blocks[0].Text, "iVBOR") || blocks[1].ImageURL != compactionTestPNG {
		t.Fatalf("image must be a real image block, not transcript text: %+v", blocks)
	}
	var responsesRequest ResponsesRequest
	if err := json.Unmarshal(requestBody, &responsesRequest); err != nil {
		t.Fatal(err)
	}
	chatRequest, err := FromResponsesRequest(responsesRequest)
	if err != nil {
		t.Fatal(err)
	}
	if len(chatRequest.Messages) != 2 || len(chatRequest.Messages[1].Images) != 1 || !strings.Contains(chatRequest.Messages[1].Content, "item_000001") {
		t.Fatalf("local Responses conversion lost the image-to-item association: %+v", chatRequest.Messages)
	}
}

func TestCompactionImageRetentionIsModelSelectedAndReplayed(t *testing.T) {
	body := []byte(`{
		"model":"test","stream":true,
		"input":[
			{"type":"message","role":"user","content":[{"type":"input_image","detail":"auto","image_url":"` + compactionTestPNG + `"}]},
			{"type":"message","role":"assistant","content":"I inspected it."},
			{"type":"compaction_trigger"}
		]
	}`)
	plan, requested, err := PrepareTriggeredCompaction(body)
	if err != nil || !requested {
		t.Fatalf("prepare: requested=%v err=%v", requested, err)
	}

	t.Run("selected", func(t *testing.T) {
		result, err := plan.Complete(compactionResponseBody(t, map[string]any{
			"summary": "The image was inspected.", "retain_item_ids": []string{"item_000001"},
		}))
		if err != nil {
			t.Fatal(err)
		}
		payload := decodeResultPayload(t, result)
		if len(payload.Retained) != 1 || len(payload.Retained[0].Images) != 1 {
			t.Fatalf("selected image was not retained: %+v", payload.Retained)
		}
		request, err := json.Marshal(map[string]any{"model": "test", "input": []any{result.Item}})
		if err != nil {
			t.Fatal(err)
		}
		expanded, changed, err := ExpandResponsesCompactionInput(request)
		if err != nil || !changed {
			t.Fatalf("expand: changed=%v err=%v", changed, err)
		}
		if !bytes.Contains(expanded, []byte(`"type":"input_image"`)) || !bytes.Contains(expanded, []byte(compactionTestPNG)) {
			t.Fatalf("retained image was not replayed as Responses content: %s", expanded)
		}
	})

	t.Run("not selected", func(t *testing.T) {
		result, err := plan.Complete(compactionResponseBody(t, map[string]any{
			"summary": "The image was inspected.", "retain_item_ids": []string{},
		}))
		if err != nil {
			t.Fatal(err)
		}
		if payload := decodeResultPayload(t, result); len(payload.Retained) != 0 {
			t.Fatalf("unselected image was retained: %+v", payload.Retained)
		}
	})
}

func TestCompactionReplaysRetainedToolOutputImagesWithTheirCall(t *testing.T) {
	body := []byte(`{
		"model":"test","stream":true,
		"input":[
			{"type":"function_call","call_id":"call_1","name":"screenshot","arguments":"{}"},
			{"type":"function_call_output","call_id":"call_1","output":[
				{"type":"input_text","text":"captured"},
				{"type":"input_image","detail":"auto","image_url":"` + compactionTestPNG + `"}
			]},
			{"type":"message","role":"assistant","content":"done"},
			{"type":"compaction_trigger"}
		]
	}`)
	plan, requested, err := PrepareTriggeredCompaction(body)
	if err != nil || !requested {
		t.Fatalf("prepare: requested=%v err=%v", requested, err)
	}
	summaryRequest, err := plan.SummaryRequest("")
	if err != nil {
		t.Fatal(err)
	}
	if !bytes.Contains(summaryRequest, []byte(compactionTestPNG)) || !bytes.Contains(summaryRequest, []byte(`image_count\":1`)) {
		t.Fatalf("compactor request did not associate the tool image with its transcript item: %s", summaryRequest)
	}
	result, err := plan.Complete(compactionResponseBody(t, map[string]any{
		"summary": "A screenshot was captured.", "retain_item_ids": []string{"item_000002"},
	}))
	if err != nil {
		t.Fatal(err)
	}
	payload := decodeResultPayload(t, result)
	if len(payload.Retained) != 2 || len(payload.Retained[0].ToolCalls) != 1 || len(payload.Retained[1].Images) != 1 {
		t.Fatalf("tool call and image result were not retained together: %+v", payload.Retained)
	}
	items, err := payloadToResponsesItems(payload)
	if err != nil {
		t.Fatal(err)
	}
	if len(items) != 4 || rawInputItemType(items[2]) != "function_call" || rawInputItemType(items[3]) != "function_call_output" {
		t.Fatalf("tool pairing or order changed: %s", items)
	}
	if !bytes.Contains(items[3], []byte(`"type":"input_image"`)) || !bytes.Contains(items[3], []byte(compactionTestPNG)) {
		t.Fatalf("tool output image was not replayed: %s", items[3])
	}
}

func TestCompactionForcesActiveToolOutputImage(t *testing.T) {
	body := []byte(`{
		"model":"test","stream":true,
		"input":[
			{"type":"function_call","call_id":"call_1","name":"screenshot","arguments":"{}"},
			{"type":"function_call_output","call_id":"call_1","output":[{"type":"input_image","detail":"auto","image_url":"` + compactionTestPNG + `"}]},
			{"type":"compaction_trigger"}
		]
	}`)
	plan, requested, err := PrepareTriggeredCompaction(body)
	if err != nil || !requested {
		t.Fatalf("prepare: requested=%v err=%v", requested, err)
	}
	result, err := plan.Complete(compactionResponseBody(t, map[string]any{
		"summary": "The screenshot tool just completed.", "retain_item_ids": []string{},
	}))
	if err != nil {
		t.Fatal(err)
	}
	payload := decodeResultPayload(t, result)
	if len(payload.Retained) != 2 || len(payload.Retained[1].Images) != 1 {
		t.Fatalf("active tool state and its image must be forced: %+v", payload.Retained)
	}
}

func TestCompactionRejectsUnsupportedImageSources(t *testing.T) {
	for name, image := range map[string]string{
		"file id":    `{"type":"input_image","detail":"auto","file_id":"file_123"}`,
		"remote URL": `{"type":"input_image","detail":"auto","image_url":"https://example.com/image.png"}`,
	} {
		t.Run(name, func(t *testing.T) {
			body := []byte(`{"model":"test","stream":true,"input":[{"type":"message","role":"user","content":[` + image + `]},{"type":"compaction_trigger"}]}`)
			_, requested, err := PrepareTriggeredCompaction(body)
			if !requested || err == nil {
				t.Fatalf("requested=%v err=%v", requested, err)
			}
		})
	}
}

func TestPrepareTriggeredCompactionRequiresStreaming(t *testing.T) {
	body := []byte(`{"model":"test","input":[{"type":"message","role":"user","content":"hi"},{"type":"compaction_trigger"}]}`)
	_, requested, err := PrepareTriggeredCompaction(body)
	if !requested || err == nil || !strings.Contains(err.Error(), "stream=true") {
		t.Fatalf("requested=%v err=%v", requested, err)
	}
}

func TestCompactionSelectionKeepsCompleteToolGroupInOriginalOrder(t *testing.T) {
	body := []byte(`{
		"model":"test",
		"stream":true,
		"input":[
			{"type":"message","role":"user","content":"run it"},
			{"type":"function_call","call_id":"call_1","name":"shell","arguments":"{}"},
			{"type":"function_call_output","call_id":"call_1","output":"ok"},
			{"type":"message","role":"assistant","content":"done"},
			{"type":"compaction_trigger"}
		]
	}`)
	plan, requested, err := PrepareTriggeredCompaction(body)
	if err != nil || !requested {
		t.Fatalf("prepare: requested=%v err=%v", requested, err)
	}

	result, err := plan.Complete(compactionResponseBody(t, map[string]any{
		"summary": "The command completed.", "retain_item_ids": []string{"item_000003"},
	}))
	if err != nil {
		t.Fatal(err)
	}
	payload := decodeResultPayload(t, result)
	if len(payload.Retained) != 2 {
		t.Fatalf("expected complete tool group, got %+v", payload.Retained)
	}
	if len(payload.Retained[0].ToolCalls) != 1 || payload.Retained[1].Role != "tool" {
		t.Fatalf("tool group order changed: %+v", payload.Retained)
	}
}

func TestCompactionPreservesNamespacedFunctionCallIdentity(t *testing.T) {
	body := []byte(`{
		"model":"test",
		"stream":true,
		"tools":[{"type":"namespace","name":"mcp__codex_apps__github","tools":[{"type":"function","name":"_get_repo","parameters":{"type":"object"}}]}],
		"input":[
			{"type":"function_call","call_id":"call_repo","namespace":"mcp__codex_apps__github","name":"_get_repo","arguments":"{\"repo\":\"ollama/ollama\"}"},
			{"type":"function_call_output","call_id":"call_repo","output":"found"},
			{"type":"message","role":"assistant","content":"done"},
			{"type":"compaction_trigger"}
		]
	}`)
	plan, requested, err := PrepareTriggeredCompaction(body)
	if err != nil || !requested {
		t.Fatalf("prepare: requested=%v err=%v", requested, err)
	}

	requestBody, err := plan.SummaryRequest("")
	if err != nil {
		t.Fatal(err)
	}
	if !bytes.Contains(requestBody, []byte(`mcp__codex_apps__github_get_repo`)) {
		t.Fatalf("summary transcript lost the namespaced tool identity: %s", requestBody)
	}

	result, err := plan.Complete(compactionResponseBody(t, map[string]any{
		"summary": "The repository was found.", "retain_item_ids": []string{"item_000002"},
	}))
	if err != nil {
		t.Fatal(err)
	}
	payload := decodeResultPayload(t, result)
	if len(payload.Retained) != 2 {
		t.Fatalf("expected complete namespaced tool group, got %+v", payload.Retained)
	}
	if got := payload.Retained[0].ToolCalls[0].Function.Name; got != "mcp__codex_apps__github_get_repo" {
		t.Fatalf("retained tool name = %q", got)
	}
}

func TestCompactionPreservesToolSearchStateAndAcceptsWebSearchHistory(t *testing.T) {
	body := []byte(`{
		"model":"test",
		"stream":true,
		"input":[
			{"type":"message","role":"user","content":"find the issue"},
			{"type":"tool_search_call","call_id":"call_search","execution":"client","status":"completed","arguments":{"query":"github"}},
			{"type":"tool_search_output","call_id":"call_search","execution":"client","status":"completed","tools":[{"type":"namespace","name":"mcp__codex_apps__github","tools":[{"type":"function","name":"_search"}]}]},
			{"type":"web_search_call","id":"ws_1","status":"completed","action":{"type":"search","query":"current issue"}},
			{"type":"message","role":"assistant","content":"I found it."},
			{"type":"compaction_trigger"}
		]
	}`)
	plan, requested, err := PrepareTriggeredCompaction(body)
	if err != nil || !requested {
		t.Fatalf("prepare: requested=%v err=%v", requested, err)
	}

	result, err := plan.Complete(compactionResponseBody(t, map[string]any{
		"summary": "The issue was found.", "retain_item_ids": []string{"item_000003"},
	}))
	if err != nil {
		t.Fatal(err)
	}
	payload := decodeResultPayload(t, result)
	if len(payload.Retained) != 2 || payload.Retained[0].ToolCalls[0].Function.Name != "tool_search" || payload.Retained[1].ToolName != "tool_search" {
		t.Fatalf("tool search state was not retained as a pair: %+v", payload.Retained)
	}

	expandedBody, err := json.Marshal(map[string]any{
		"model": "test",
		"input": []any{result.Item, map[string]any{"type": "message", "role": "user", "content": "continue"}},
	})
	if err != nil {
		t.Fatal(err)
	}
	rewritten, changed, err := ExpandResponsesCompactionInput(expandedBody)
	if err != nil || !changed {
		t.Fatalf("expand: changed=%v err=%v", changed, err)
	}
	var request struct {
		Input []json.RawMessage `json:"input"`
	}
	if err := json.Unmarshal(rewritten, &request); err != nil {
		t.Fatal(err)
	}
	wantTypes := []string{"function_call", "function_call_output", "tool_search_call", "tool_search_output", "message"}
	if len(request.Input) != len(wantTypes) {
		t.Fatalf("expanded input = %s", rewritten)
	}
	for i, want := range wantTypes {
		if got := rawInputItemType(request.Input[i]); got != want {
			t.Fatalf("expanded input[%d] type = %q, want %q: %s", i, got, want, rewritten)
		}
	}
}

func TestCompactionRejectsInvalidToolStateAndSelections(t *testing.T) {
	t.Run("orphan result", func(t *testing.T) {
		body := []byte(`{"model":"test","stream":true,"input":[{"type":"function_call_output","call_id":"missing","output":"x"},{"type":"compaction_trigger"}]}`)
		_, requested, err := PrepareTriggeredCompaction(body)
		if !requested || err == nil || !strings.Contains(err.Error(), "no matching call") {
			t.Fatalf("requested=%v err=%v", requested, err)
		}
	})

	t.Run("unknown ref", func(t *testing.T) {
		body := []byte(`{"model":"test","stream":true,"input":[{"type":"message","role":"user","content":"hi"},{"type":"compaction_trigger"}]}`)
		plan, _, err := PrepareTriggeredCompaction(body)
		if err != nil {
			t.Fatal(err)
		}
		_, err = plan.Complete(compactionResponseBody(t, map[string]any{
			"summary": "hi", "retain_item_ids": []string{"missing"},
		}))
		if err == nil || !strings.Contains(err.Error(), "unknown item") {
			t.Fatalf("expected unknown item error, got %v", err)
		}
	})
}

func TestExpandResponsesCompactionInputPreservesCodexRetainedPrefix(t *testing.T) {
	payload := OllamaCompactionPayload{
		Type: OllamaCompactionPayloadType, Version: OllamaCompactionPayloadVersion,
		Summary: "The user chose option A.",
		Retained: []api.Message{{Role: "assistant", ToolCalls: []api.ToolCall{{
			ID: "call_live", Function: api.ToolCallFunction{Name: "shell", Arguments: api.NewToolCallFunctionArguments()},
		}}}},
	}
	payloadJSON, err := json.Marshal(payload)
	if err != nil {
		t.Fatal(err)
	}
	body, err := json.Marshal(map[string]any{
		"model": "test",
		"input": []any{
			map[string]any{"type": "message", "role": "user", "content": "first user turn retained by Codex"},
			map[string]any{"type": "message", "role": "user", "content": "second user turn retained by Codex"},
			ResponsesCompactionItem{Type: "compaction", EncryptedContent: string(payloadJSON)},
			map[string]any{"type": "message", "role": "user", "content": "new turn"},
		},
	})
	if err != nil {
		t.Fatal(err)
	}

	rewritten, changed, err := ExpandResponsesCompactionInput(body)
	if err != nil {
		t.Fatal(err)
	}
	if !changed {
		t.Fatal("expected rewritten input")
	}
	var request struct {
		Input []json.RawMessage `json:"input"`
	}
	if err := json.Unmarshal(rewritten, &request); err != nil {
		t.Fatal(err)
	}
	if len(request.Input) != 6 {
		t.Fatalf("expected retained prefix, summary pair, retained call, and new turn; got %s", rewritten)
	}
	var types []string
	for _, item := range request.Input {
		types = append(types, rawInputItemType(item))
	}
	want := []string{"message", "message", "function_call", "function_call_output", "function_call", "message"}
	for i := range want {
		if types[i] != want[i] {
			t.Fatalf("types=%v want=%v", types, want)
		}
	}
	for _, marker := range []string{"first user turn retained by Codex", "second user turn retained by Codex"} {
		if strings.Count(string(rewritten), marker) != 1 {
			t.Fatalf("retained user message %q was lost or duplicated: %s", marker, rewritten)
		}
	}
	if !strings.Contains(string(rewritten), "new turn") {
		t.Fatalf("post-boundary input was lost: %s", rewritten)
	}
}

// Accepting retained items does not mean a foreign checkpoint was recovered.
// Each destination is responsible for validating the retained item schemas.
func TestExpandResponsesCompactionInputRequiresRemainingItems(t *testing.T) {
	for _, tt := range []struct {
		name      string
		remaining string
		wantErr   bool
	}{
		{"no remaining items", "", true},
		{"only foreign checkpoints", `,{"type":"compaction","encrypted_content":"other-provider"}`, true},
		{"Codex retained user", `,{"role":"user","content":"continue"}`, false},
		{"search metadata only", `,{"type":"web_search_call","id":"ws_1","status":"completed"}`, false},
		{"encrypted reasoning only", `,{"type":"reasoning","summary":[],"encrypted_content":"opaque"}`, false},
		{"empty message", `,{"role":"user","content":" "}`, false},
		{"empty routed agent message", `,{"type":"agent_message","author":"worker","recipient":"root","content":[]}`, false},
		{"orphan empty tool result", `,{"type":"function_call_output","call_id":"missing-call","output":""}`, false},
		{"incomplete tool definition", `,{"type":"tool_search_output","tools":[{}]}`, false},
		{"provider call", `,{"type":"shell_call","call_id":"call_1","action":{"commands":["true"]}}`, false},
	} {
		t.Run(tt.name, func(t *testing.T) {
			body := []byte(`{"model":"test","input":[{"type":"compaction","encrypted_content":"opaque-provider-state"}` + tt.remaining + `]}`)
			_, changed, err := ExpandResponsesCompactionInput(body)
			if (err != nil) != tt.wantErr || changed == tt.wantErr {
				t.Errorf("expand: changed=%v err=%v, wantErr=%v", changed, err, tt.wantErr)
			}
			if tt.wantErr && (err == nil || !strings.Contains(err.Error(), "resend conversation history")) {
				t.Errorf("expected empty-history recovery error, got %v", err)
			}
		})
	}
}

func TestRepeatedCompactionReplacesRatherThanNestsPayload(t *testing.T) {
	oldPayload, err := json.Marshal(OllamaCompactionPayload{
		Type: OllamaCompactionPayloadType, Version: OllamaCompactionPayloadVersion, Summary: "old summary",
	})
	if err != nil {
		t.Fatal(err)
	}
	body, err := json.Marshal(map[string]any{
		"model": "test", "stream": true,
		"input": []any{
			map[string]any{"type": "message", "role": "user", "content": "retained prefix"},
			ResponsesCompactionItem{Type: "compaction", EncryptedContent: string(oldPayload)},
			map[string]any{"type": "message", "role": "user", "content": "new work"},
			ResponsesCompactionTrigger{Type: "compaction_trigger"},
		},
	})
	if err != nil {
		t.Fatal(err)
	}
	plan, requested, err := PrepareTriggeredCompaction(body)
	if err != nil || !requested {
		t.Fatalf("prepare: requested=%v err=%v", requested, err)
	}
	result, err := plan.Complete(compactionResponseBody(t, map[string]any{
		"summary": "replacement summary", "retain_item_ids": []string{},
	}))
	if err != nil {
		t.Fatal(err)
	}
	payload := decodeResultPayload(t, result)
	if len(payload.Retained) != 0 {
		t.Fatalf("old synthetic summary pair was retained: %+v", payload.Retained)
	}
	if strings.Contains(result.Item.EncryptedContent, "old summary") || strings.Contains(result.Item.EncryptedContent, "retained prefix") {
		t.Fatalf("old compaction was nested: %s", result.Item.EncryptedContent)
	}
}

func TestCompactionStreamContainsExactlyOneCompletedItem(t *testing.T) {
	result := ResponsesCompactionResult{Item: ResponsesCompactionItem{Type: "compaction", EncryptedContent: `{"type":"ollama_compaction","version":1}`}}
	events := NewResponsesCompactionStreamEvents("resp_1", "test", result)
	var done, completed int
	for _, event := range events {
		switch event.Event {
		case "response.output_item.done":
			done++
			data := event.Data.(map[string]any)
			item := data["item"].(ResponsesCompactionItem)
			if item.Type != "compaction" {
				t.Fatalf("unexpected item: %+v", item)
			}
		case "response.completed":
			completed++
		}
	}
	if done != 1 || completed != 1 {
		t.Fatalf("done=%d completed=%d events=%+v", done, completed, events)
	}
}

func TestCompactionMessageAgentMessage(t *testing.T) {
	var item ResponsesAgentMessageInput
	err := json.Unmarshal([]byte(`{
		"type": "agent_message",
		"author": "/root",
		"recipient": "/root/worker",
		"content": [
			{"type": "input_text", "text": "Message Type: NEW_TASK\nPayload:\n"},
			{"type": "encrypted_content", "encrypted_content": "analyze the parser"},
			{"type": "input_image", "image_url": "data:image/png;base64,Zml4dHVyZQ=="}
		]
	}`), &item)
	if err != nil {
		t.Fatal(err)
	}

	msg, kind, err := compactionMessage(item)
	if err != nil {
		t.Fatal(err)
	}
	want := AgentMessageEnvelopeFormat + "Message Type: NEW_TASK\nPayload:\nanalyze the parser"
	want = fmt.Sprintf(want, "/root", "/root/worker")
	if kind != "message" || msg.Role != "user" || msg.Content != want || len(msg.Images) != 0 {
		t.Fatalf("kind=%q msg=%#v", kind, msg)
	}
}