notarius/internal/modules/dnd/chunk/scenes/scriptorium_assets_test.go

package scenes

import (
	"context"
	"encoding/json"
	"strings"
	"testing"
	"time"

	"gitea.maximumdirect.net/eric/notarius/internal/framework/llm"
	"gitea.maximumdirect.net/eric/scriptorium"
)

func TestScriptoriumPromptPreparesTranscriptAndTaskMessages(t *testing.T) {
	transcript := []byte(`{"id":"session-1","segments":[{"id":"u1","text":"We enter the crypt."}]}`)
	prepared := prepareScenesPrompt(t, transcript, "Alice: Aria", "Aria: cleric", "Brightmantle: temple")

	if prepared.PromptID != PromptID {
		t.Fatalf("prompt id = %q, want %q", prepared.PromptID, PromptID)
	}
	transcriptMessages := 0
	referenceMessageFound := false
	for _, message := range prepared.Messages {
		if strings.Contains(message.Content, string(transcript)) {
			transcriptMessages++
			if message.Role != "user" || message.CacheControl == nil {
				t.Fatalf("transcript message did not render as cacheable user message: %#v", message)
			}
		}
		if strings.Contains(message.Content, "Alice: Aria") &&
			strings.Contains(message.Content, "Aria: cleric") &&
			strings.Contains(message.Content, "Brightmantle: temple") {
			referenceMessageFound = true
			if message.Role != "user" || message.CacheControl == nil {
				t.Fatalf("reference message did not render as cacheable user message: %#v", message)
			}
		}
	}
	if transcriptMessages != 1 {
		t.Fatalf("raw transcript rendered in %d messages, want exactly one", transcriptMessages)
	}
	if !referenceMessageFound {
		t.Fatalf("reference message did not render all supplied reference material")
	}
}

func TestScriptoriumPromptDiagnosticsOmitRawMaterials(t *testing.T) {
	transcript := []byte(`{"secret":"source text"}`)
	prepared := prepareScenesPrompt(t, transcript, "private player note", "private party note", "private glossary note")
	metadata := newChunker(t, &fakeScenesLLMClient{}).ManifestMetadata()

	payload, err := json.Marshal(map[string]any{
		"prepared": map[string]any{
			"prompt_id":              prepared.PromptID,
			"prompt_version":         prepared.PromptVersion,
			"prompt_hash":            prepared.PromptHash,
			"rendered_prompt_hash":   prepared.RenderedPromptHash,
			"selected_profile_id":    prepared.SelectedProfileID,
			"output_contract":        prepared.OutputContract,
			"input_hashes":           prepared.InputHashes,
			"effective_model_params": prepared.EffectiveModelParams,
		},
		"manifest": metadata,
	})
	if err != nil {
		t.Fatalf("marshal diagnostics: %v", err)
	}
	diagnostics := string(payload)
	for _, forbidden := range []string{
		"source text",
		"private player note",
		"private party note",
		"private glossary note",
		`"properties"`,
		"start_unit_id",
	} {
		if strings.Contains(diagnostics, forbidden) {
			t.Fatalf("diagnostics leaked %q: %s", forbidden, diagnostics)
		}
	}
	if metadata["prompt_id"] != PromptID || metadata["prompt_version"] != ResponseSchemaVersion {
		t.Fatalf("manifest prompt metadata = %#v", metadata)
	}
	if !strings.HasPrefix(metadata["prompt_sha256"].(string), "sha256:") {
		t.Fatalf("manifest prompt hash = %#v, want sha256-prefixed", metadata["prompt_sha256"])
	}
}

func prepareScenesPrompt(t *testing.T, transcript []byte, players string, party string, glossary string) *scriptorium.PreparedRun {
	t.Helper()
	registry := llm.NewAssetRegistry()
	if err := RegisterPromptAssets(registry); err != nil {
		t.Fatalf("register scene prompt assets: %v", err)
	}
	engine := newScenesScriptoriumEngine(t, registry)
	prepared, err := engine.Prepare(context.Background(), scriptorium.RunRequest{
		PromptID:      PromptID,
		PromptVersion: ResponseSchemaVersion,
		ProfileID:     "scene-test-profile",
		Inputs: map[string]scriptorium.ArtifactRef{
			"transcript": scriptorium.InlineWithURI("file:///session.json", string(transcript)),
			"players":    scriptorium.Inline(players),
			"party":      scriptorium.Inline(party),
			"glossary":   scriptorium.Inline(glossary),
		},
	})
	if err != nil {
		t.Fatalf("Prepare() error = %v, want nil", err)
	}
	return prepared
}

func newScenesScriptoriumEngine(t *testing.T, registry *llm.AssetRegistry) *scriptorium.Engine {
	t.Helper()
	options, err := registry.ScriptoriumOptions()
	if err != nil {
		t.Fatalf("ScriptoriumOptions() error = %v, want nil", err)
	}
	options = append(options, scriptorium.WithProfiles(scriptorium.OpenAICompatibleProfile(scriptorium.OpenAICompatibleProfileConfig{
		ID:       "scene-test-profile",
		Endpoint: "http://127.0.0.1:1/v1",
		Model:    "scene-test-model",
	})))
	engine, err := scriptorium.NewEngine(scriptorium.Config{Timeout: time.Second}, options...)
	if err != nil {
		t.Fatalf("NewEngine() error = %v, want nil", err)
	}
	return engine
}