The highest tagged major version is v7.

session

package

v0.16.0 Latest Latest Go to latest Published: Jul 18, 2026 License: MIT Imports: 2 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/floegence/floret

Links

Open Source Insights

Documentation ¶

Overview ¶

Package session defines the provider-visible transcript shape and low-level ephemeral transcript store.

Message is the normalized transcript item passed to providers after host and control projections have been applied. Store is a run-scoped transcript cache for low-level engine execution; it is not the recommended durable persistence API for host applications. Durable conversations should use sessiontree.Repo through agentharness.Thread.

Index ¶

type ActivityChip
type ActivityPresentation
- func CloneActivityPresentation(in *ActivityPresentation) *ActivityPresentation
type ActivityTargetRef
type ControlSignalView
- func CloneControlSignalView(in *ControlSignalView) *ControlSignalView
type MemoryStore
- func NewMemoryStore() *MemoryStore
type Message
- func CloneMessage(msg Message) Message
- func CloneMessages(messages []Message) []Message
type MessageAttachment
type MessageKind
type Role
type ToolResultView
type TranscriptStore

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type ActivityChip ¶ added in v0.3.47

type ActivityChip struct {
	Kind  string `json:"kind"`
	Label string `json:"label"`
	Value string `json:"value,omitempty"`
	Tone  string `json:"tone,omitempty"`
}

type ActivityPresentation ¶ added in v0.3.47

type ActivityPresentation struct {
	Label       string              `json:"label,omitempty"`
	Description string              `json:"description,omitempty"`
	Renderer    string              `json:"renderer,omitempty"`
	Chips       []ActivityChip      `json:"chips,omitempty"`
	TargetRefs  []ActivityTargetRef `json:"target_refs,omitempty"`
	Payload     map[string]any      `json:"payload,omitempty"`
}

func CloneActivityPresentation ¶ added in v0.3.47

func CloneActivityPresentation(in *ActivityPresentation) *ActivityPresentation

type ActivityTargetRef ¶ added in v0.3.47

type ActivityTargetRef struct {
	Kind  string `json:"kind"`
	Label string `json:"label"`
	URI   string `json:"uri,omitempty"`
	Path  string `json:"path,omitempty"`
	Line  int    `json:"line,omitempty"`
}

type ControlSignalView ¶ added in v0.11.0

type ControlSignalView struct {
	Name        string         `json:"name,omitempty"`
	CallID      string         `json:"call_id,omitempty"`
	Disposition string         `json:"disposition,omitempty"`
	OutputText  string         `json:"output_text,omitempty"`
	ArgsHash    string         `json:"args_hash,omitempty"`
	Payload     map[string]any `json:"payload,omitempty"`
}

func CloneControlSignalView ¶ added in v0.11.0

func CloneControlSignalView(in *ControlSignalView) *ControlSignalView

type MemoryStore ¶

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

func NewMemoryStore ¶

func NewMemoryStore() *MemoryStore

func (*MemoryStore) AppendTranscript ¶

func (s *MemoryStore) AppendTranscript(runID string, messages ...Message) error

func (*MemoryStore) ReplaceTranscript ¶

func (s *MemoryStore) ReplaceTranscript(runID string, messages []Message) error

func (*MemoryStore) Transcript ¶

func (s *MemoryStore) Transcript(runID string) ([]Message, error)

type Message ¶

type Message struct {
	Role                 Role
	Content              string
	Attachments          []MessageAttachment
	Reasoning            string
	ToolCallID           string
	ToolName             string
	ToolArgs             string
	EntryID              string
	ParentEntryID        string
	Kind                 MessageKind
	ToolResult           *ToolResultView
	Activity             *ActivityPresentation `json:"activity,omitempty"`
	ControlSignal        *ControlSignalView    `json:"control_signal,omitempty"`
	CompactionID         string
	CompactionGeneration int
	CompactionWindowID   string
}

func CloneMessage ¶

func CloneMessage(msg Message) Message

func CloneMessages ¶

func CloneMessages(messages []Message) []Message

type MessageAttachment ¶ added in v0.12.0

type MessageAttachment struct {
	ResourceRef string `json:"resource_ref"`
	Name        string `json:"name"`
	MIMEType    string `json:"mime_type"`
	SizeBytes   int64  `json:"size_bytes,omitempty"`
}

MessageAttachment is one durable host-owned resource reference associated with a user message. Floret persists and projects the opaque reference but never resolves or reads the resource itself.

type MessageKind ¶

type MessageKind string

const (
	MessageKindNormal            MessageKind = ""
	MessageKindCompactionSummary MessageKind = "compaction_summary"
	MessageKindControlSignal     MessageKind = "control_signal"
)

type Role ¶

type Role string

const (
	System    Role = "system"
	User      Role = "user"
	Assistant Role = "assistant"
	Tool      Role = "tool"
)

type ToolResultView ¶

type ToolResultView struct {
	Status        string        `json:"status,omitempty"`
	Truncated     bool          `json:"truncated,omitempty"`
	OriginalBytes int           `json:"original_bytes,omitempty"`
	VisibleBytes  int           `json:"visible_bytes,omitempty"`
	OriginalLines int           `json:"original_lines,omitempty"`
	VisibleLines  int           `json:"visible_lines,omitempty"`
	Strategy      string        `json:"strategy,omitempty"`
	ContentSHA256 string        `json:"content_sha256,omitempty"`
	FullOutput    *artifact.Ref `json:"full_output,omitempty"`
}

type TranscriptStore ¶

type TranscriptStore interface {
	AppendTranscript(runID string, messages ...Message) error
	Transcript(runID string) ([]Message, error)
	ReplaceTranscript(runID string, messages []Message) error
}

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
artifact
compaction
contextpolicy

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL