prompt

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

type BuildInput struct {
	// Sections are the prompt sections
	Sections []Section `json:"sections"`

	// Variables are template variables
	Variables map[string]string `json:"variables,omitempty"`

	// OverrideSystemPrompt overrides the system prompt entirely
	OverrideSystemPrompt *string `json:"override_system_prompt,omitempty"`

	// Model is the model being used
	Model string `json:"model,omitempty"`
}

type BuildResult struct {
	// SystemPrompt is the assembled system prompt
	SystemPrompt string `json:"system_prompt"`

	// CacheBreakpoint is where the cache boundary is
	CacheBreakpoint int `json:"cache_breakpoint"`

	// StaticText is the cacheable part
	StaticText string `json:"static_text"`

	// DynamicText is the non-cacheable part
	DynamicText string `json:"dynamic_text"`

	// FullText is the complete prompt
	FullText string `json:"full_text"`

	// VariablesUsed are the variables that were used
	VariablesUsed []string `json:"variables_used,omitempty"`
}

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

type BuilderConfig struct {
	EnableCaching         bool `json:"enable_caching"`
	CacheBoundaryPosition int  `json:"cache_boundary_position"`
}

type CacheEntry struct {
	Content      string
	ComputedAt   time.Time
	SectionNames []string
	ToolHash     string
	ModelConfig  string
	ValidUntil   *time.Time // nil = valide jusqu'à invalidation explicite
}

type CacheHitResult struct {
	Content  string
	CachedAt time.Time
	ToolHash string
	IsStale  bool
}

type CacheSafeParams struct {
	SystemPrompt  string
	UserContext   map[string]string
	SystemContext map[string]string
	Tools         map[string]tool.Tool
	Model         types.ModelIdentifier
	CustomPrompt  *string
	AppendPrompt  *string
}

type CacheSafePrompt struct {
	SystemPrompt       string                    `json:"system_prompt"`
	StableText         string                    `json:"stable_text"`
	DynamicText        string                    `json:"dynamic_text"`
	CacheBreakpoint    int                       `json:"cache_breakpoint"`
	UserContext        map[string]string         `json:"user_context,omitempty"`
	SystemContext      map[string]string         `json:"system_context,omitempty"`
	SystemPromptBlocks []types.SystemPromptBlock `json:"system_prompt_blocks,omitempty"`
}

type ExecutionStage string

type FetchSystemPromptPartsInput struct {
	Tools                        map[string]tool.Tool  `json:"-"`
	Model                        types.ModelIdentifier `json:"model"`
	WorkingDirectory             string                `json:"working_directory,omitempty"`
	DeferredToolNames            []string              `json:"deferred_tool_names,omitempty"`
	MemoryContext                string                `json:"memory_context,omitempty"`
	AdditionalWorkingDirectories []string              `json:"additional_working_directories,omitempty"`
	MCPClients                   []string              `json:"mcp_clients,omitempty"`
	CustomSystemPrompt           *string               `json:"custom_system_prompt,omitempty"`
	AppendSystemPrompt           *string               `json:"append_system_prompt,omitempty"`

	// Stage sets the execution stage overlay injected into the dynamic section.
	Stage ExecutionStage `json:"stage,omitempty"`

	// StageOverrides replaces the built-in stage overlay text per stage.
	StageOverrides map[ExecutionStage]string `json:"-"`

	// ToolHints provides per-tool extra guidance appended to provider-facing
	// tool descriptions. Key is the canonical tool name.
	ToolHints map[string]string `json:"-"`

	// ProjectInstructions is the content of a project-level instructions file
	// (e.g. SESHAT.md, AGENTS.md). Injected into the system prompt before the
	// memory context section so it takes precedence over accumulated patterns.
	ProjectInstructions string `json:"project_instructions,omitempty"`
}

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

type Section struct {
	// Type is the section type
	Type SectionType `json:"type"`

	// Name identifies this section
	Name string `json:"name"`

	// Content is the section content
	Content string `json:"content"`

	// Priority determines order (higher = earlier)
	Priority int `json:"priority"`

	// Cacheable indicates if this section can be cached
	Cacheable bool `json:"cacheable"`

	// DynamicBoundary indicates this section marks the cache boundary
	DynamicBoundary bool `json:"dynamic_boundary"`

	// Enabled indicates if this section is active
	Enabled bool `json:"enabled"`
}

type SectionType string

type SystemPromptParts struct {
	DefaultSystemPrompt []string          `json:"default_system_prompt"`
	UserContext         map[string]string `json:"user_context"`
	SystemContext       map[string]string `json:"system_context"`
	StableText          string            `json:"stable_text,omitempty"`
	DynamicText         string            `json:"dynamic_text,omitempty"`
	CacheBreakpoint     int               `json:"cache_breakpoint,omitempty"`

	// Stage and StageOverrides are propagated to BuildCanonicalPrompt so the
	// dynamic section remains stage-aware across the two-phase build path.
	Stage          ExecutionStage            `json:"stage,omitempty"`
	StageOverrides map[ExecutionStage]string `json:"-"`

	// ToolHints provides per-tool extra guidance used when building provider
	// tool definitions for this turn.
	ToolHints map[string]string `json:"-"`
}