resume

type InMemoryTranscriptStore struct {
	// contains filtered or unexported fields
}

type InMemoryTranscriptStoreOption func(*InMemoryTranscriptStore)

type MetadataSetter interface {
	SetMetadata(runID, stepID, systemPrompt, model string)
}

type StepTranscript struct {
	StepID       string
	RunID        string
	Messages     []provider.Message
	SystemPrompt string
	Model        string // "provider:model-id" - consumer reconstructs
	SavedAt      time.Time
}

type TranscriptStore interface {
	// Append adds messages to stepID's transcript under runID. Returns
	// ErrTranscriptTooLarge when the transcript would exceed the
	// configured size cap. On cap-exceeded the returned
	// error wraps ErrTranscriptTooLarge and the messages ARE NOT
	// appended - the caller should surface the cap to the router so it
	// can emit DropReasonTranscriptTooLarge.
	Append(runID, stepID string, msgs []provider.Message) error

	// Load returns the full transcript for (runID, stepID). Returns
	// ErrNoTranscript when no transcript exists. Returns
	// ErrTranscriptTooLarge when a prior Append hit the cap and sealed
	// the slot - callers (Router via Executor.ResumeStep) MUST surface
	// DropReasonTranscriptTooLarge rather than resuming from a
	// truncated history. The returned *StepTranscript is a defensive
	// copy - callers may mutate the Messages slice without affecting
	// the store.
	Load(runID, stepID string) (*StepTranscript, error)

	// Delete removes a transcript. Idempotent: returns nil if no
	// transcript exists.
	Delete(runID, stepID string) error
}

type TranscriptTruncatedLoader interface {
	// LoadTruncated returns up to maxMessages tail messages from the
	// sealed transcript. Returns ErrNoTranscript when no transcript
	// exists. Never returns ErrTranscriptTooLarge - the whole point
	// is to bypass the seal.
	LoadTruncated(runID, stepID string, maxMessages int) (*StepTranscript, error)
}