promptkit/exchange.go

package promptkit

import "go.maximumdirect.net/promptkit/internal/domain"

const exchangeString = "promptkit.Exchange{opaque}"

// Exchange is an immutable, reusable in-process snapshot of a completed
// conversation. It is not a persistence or restart format. Different engines
// can continue it, and independent branches do not alter one another.
type Exchange struct{ internal *domain.Exchange }

// ExchangeDetails contains a detached copy of an exchange's logical history.
type ExchangeDetails struct {
	RunID       string            `json:"run_id"`
	ParentRunID string            `json:"parent_run_id,omitempty"`
	Messages    []RenderedMessage `json:"messages"`
}

// Details returns detached history, or zero details for a nil or empty handle.
// Messages include caller and model content and require appropriate handling.
func (e *Exchange) Details() ExchangeDetails {
	if e == nil || e.internal == nil {
		return ExchangeDetails{}
	}
	return ExchangeDetails{RunID: e.internal.RunID(), ParentRunID: e.internal.ParentRunID(), Messages: fromDomainRenderedMessages(e.internal.Messages())}
}

// String returns an opaque representation without conversation content.
func (e Exchange) String() string { return exchangeString }

// GoString returns an opaque representation without conversation content.
func (e Exchange) GoString() string { return exchangeString }