dino

type ApprovalError string

type ApprovalRejectedError = dinoTools.ApprovalRejectedError

type ApprovalSender interface {
	SendToolApprovalRequest(sessionID, requestID, toolName, arguments string)
	SendToolApprovalResponse(sessionID, requestID, toolName string, approved bool)
}

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

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

type AssistantMeta struct {
	System   []string      `json:"system"`
	ModelID  string        `json:"model_id"`
	Provider string        `json:"provider"`
	Path     AssistantPath `json:"path"`
	Cost     float64       `json:"cost"`
	Summary  bool          `json:"summary,omitempty"`
	Tokens   TokenInfo     `json:"tokens"`
}

type AssistantPath struct {
	CWD  string `json:"cwd"`
	Root string `json:"root"`
}

type Budget = agentutils.Budget

type BudgetConfig struct {
	Enabled      bool  `yaml:"enabled"`
	MaxTokens    int   `yaml:"max_tokens"`
	MaxToolCalls int   `yaml:"max_tool_calls"`
	MaxTimeMs    int64 `yaml:"max_time_ms"`
}

type BudgetRequest = agentutils.BudgetRequest

type BudgetResult = agentutils.BudgetResult

type BudgetState = agentutils.BudgetState

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

type BusEvent struct {
	Type      string      `json:"type"`
	SessionID string      `json:"session_id"`
	Data      interface{} `json:"data,omitempty"`
}

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

type ClientOption func(*clientConfig)

type ClientSession struct {
	*Session
	// contains filtered or unexported fields
}

type Config struct {
	DefaultModel          string                                                            `yaml:"default_model"`
	DefaultProvider       string                                                            `yaml:"default_provider"`
	Temperature           float32                                                           `yaml:"temperature"`
	MaxTokens             int                                                               `yaml:"max_tokens"`
	TopP                  float32                                                           `yaml:"top_p"`
	Timeout               time.Duration                                                     `yaml:"timeout"`
	SystemPrompt          string                                                            `yaml:"system_prompt"`
	MaxIterations         int                                                               `yaml:"max_iterations"`
	MaxSessions           int                                                               `yaml:"max_sessions"`
	ToolExecutionTimeout  time.Duration                                                     `yaml:"tool_execution_timeout"`
	ToolTimeouts          map[string]time.Duration                                          `yaml:"tool_timeouts"`
	ToolTimeoutCalculator func(toolName string, input map[string]interface{}) time.Duration `json:"-" yaml:"-"`
	LoopDetection         LoopDetectionConfig                                               `yaml:"loop_detection"`
	Budget                BudgetConfig                                                      `yaml:"budget"`
	Tools                 ToolConfig                                                        `yaml:"tools"`
	Permission            map[string]interface{}                                            `yaml:"permission"`
	WorkspaceRoot         string                                                            `yaml:"workspace_root"`
	Skills                SkillsConfig                                                      `yaml:"skills"`
	Provider              ProviderConfig                                                    `yaml:"provider"`
	PlannerMode           PlannerModeConfig                                                 `yaml:"planner_mode"`
	Memory                MemoryConfig                                                      `yaml:"memory"`
	PromptCaching         PromptCachingConfig                                               `yaml:"prompt_caching"`
	LongTermMemory        MemLongTermConfig                                                 `yaml:"long_term_memory"`
	Subagent              agent.SubagentConfig                                              `yaml:"subagent"`
	MCP                   MCPConfig                                                         `yaml:"mcp"`
	Trace                 TraceConfig                                                       `yaml:"trace"`
}

type Cost = agentutils.Cost

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

type DinoFactory interface {
	CreateSession(ctx context.Context, sessionID string, opts ...session.Option) (*session.Session, error)
	GetSession(sessionID string) *session.Session
	CloseSession(sessionID string)
	CloseAll()
	GetTools() []types.Tool
	GetSkills() []*Skill
	Shutdown(ctx context.Context) error
	GetLLMProvider() types.LLMProvider
	GetPlannerConfig() *PlannerModeConfig
	Budget() Budget
	RespondToolApproval(requestID string, approved bool)
	SaveSessionSnapshot(ctx context.Context, sessionID string, dir string) (string, error)
	RestoreSessionSnapshot(ctx context.Context, sessionID string, snapPath string) error
}

type Event = session.Event

type EventHandler func(event *Event)

type EventSource = session.EventSource

type EventType = session.EventType

type ExecuteRequest struct {
	SessionID         string
	Content           string
	Files             []FileAttachment
	ExtraSystemPrompt string
	Stream            bool
}

type ExecuteResponse = session.ExecuteResponse

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

type FactoryOption func(*dinoFactory)

type FileAttachment struct {
	Path    string
	Name    string
	Content []byte
}

type FilePart struct {
	Type      string `json:"type"`
	MediaType string `json:"media_type"`
	Filename  string `json:"filename,omitempty"`
	URL       string `json:"url"`
}

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

type LLMProviderFactory func(config *Config) (types.LLMProvider, error)

type LoopDetectionConfig struct {
	Enabled             bool    `yaml:"enabled"`
	MaxRepeats          int     `yaml:"max_repeats"`
	SimilarityThreshold float64 `yaml:"similarity_threshold"`
	InputMaxRepeats     int     `yaml:"input_max_repeats"`
}

type MCPConfig struct {
	Enabled bool                       `yaml:"enabled"`
	Servers map[string]MCPServerConfig `yaml:"servers"`
}

type MCPServerConfig struct {
	Type    string            `yaml:"type"` // "remote" | "stdio"
	URL     string            `yaml:"url,omitempty"`
	Command string            `yaml:"command,omitempty"`
	Args    []string          `yaml:"args,omitempty"`
	Env     map[string]string `yaml:"env,omitempty"`
	Headers map[string]string `yaml:"headers,omitempty"`
	Timeout time.Duration     `yaml:"timeout,omitempty"`
	OAuth   *OAuthConfig      `yaml:"oauth,omitempty"`
	Enabled bool              `yaml:"enabled"`
}

type MemLongTermConfig = mem.MemLongTermConfig

type MemoryConfig struct {
	EnableCompress     bool   `yaml:"enable_compress"`
	EnableLLMCompress  bool   `yaml:"enable_llm_compress"` // 压缩是否走 LLM 摘要（Hybrid 包裹）；false 退回 DeterministicCompact。与 EnableCompress（是否压缩）语义正交
	MaxHistoryMessages int    `yaml:"max_history_messages"`
	MaxBudgetTokens    int    `yaml:"max_budget_tokens"`
	CompactAfterTurns  int    `yaml:"compact_after_turns"`
	CompressThreshold  int    `yaml:"compress_threshold"` // message-count gate for async compress; if <=0, CreateSession uses budget.max_tool_calls/2 then agent default
	KeepRecentCount    int    `yaml:"keep_recent_count"`
	PersistDirectory   string `yaml:"persist_directory"`
	PersistFileName    string `yaml:"persist_file_name"`
	PersistEnabled     bool   `yaml:"persist_enabled"`
	Type               string `yaml:"type"` // "memory" or "sqlite"
	// CompactionPrefix enables prefix-preserving compaction (P3.1 · prompt
	// caching Step 4): trimHistoryToTokenBudget keeps a head cache anchor and
	// preserves the recent tail verbatim, replacing the middle with a summary,
	// so prompt-cache segments 1-2 (system+tools) survive compaction. Default
	// off (conservative): the trim output structure changes when on.
	CompactionPrefix bool `yaml:"compaction_prefix"`
	// CacheAnchorTokens caps the head-cache-anchor budget (tokens). 0 = no
	// anchor (the head is trimmed like today). Default 0. Suggest ≤30% of
	// MaxBudgetTokens so the tail keeps enough room to anchor segment 3 (R5).
	CacheAnchorTokens int `yaml:"cache_anchor_tokens"`
}

type Message struct {
	ID       string           `json:"id"`
	Role     MessageRole      `json:"role"`
	Parts    []Part           `json:"parts"`
	Metadata *MessageMetadata `json:"metadata,omitempty"`
}

type MessageError struct {
	Name    string `json:"name"`
	Message string `json:"message"`
}

type MessageInfo struct {
	Role    string
	Content string
	Parts   []PartInfo
}

type MessageMetadata struct {
	Time      MessageTime         `json:"time"`
	Error     *MessageError       `json:"error,omitempty"`
	SessionID string              `json:"session_id"`
	Tool      map[string]ToolMeta `json:"tool,omitempty"`
	Assistant *AssistantMeta      `json:"assistant,omitempty"`
	Snapshot  string              `json:"snapshot,omitempty"`
}

type MessageRole string

type MessageTime struct {
	Created   int64 `json:"created"`
	Completed int64 `json:"completed,omitempty"`
}

type OAuthConfig struct {
	ClientID     string `yaml:"client_id"`
	ClientSecret string `yaml:"client_secret"`
	Scope        string `yaml:"scope"`
}

type Observer = session.Observer

type ObserverFunc = session.ObserverFunc

type OutputObserver = session.OutputObserver

type Part interface {
	// contains filtered or unexported methods
}

type PartInfo struct {
	Type   string
	Text   string
	Tool   string
	CallID string
	State  ToolState
	Input  map[string]interface{}
	Output string
	Error  string
}

type PermissionRequest struct {
	Permission string
	SessionID  string
	Input      map[string]interface{}
	Metadata   map[string]interface{}
}

type Plan = session.Plan

type PlanStep = session.PlanStep

type PlannerModeConfig struct {
	Enabled     bool   `yaml:"enabled"`
	PromptPlan  string `yaml:"prompt_plan"`
	AutoApprove bool   `yaml:"auto_approve"`
}

type PromptCachingConfig struct {
	Enabled          bool  `yaml:"enabled"` // default true (pure cost optimization)
	SystemBreakpoint *bool `yaml:"system_breakpoint,omitempty"`
	ToolsBreakpoint  *bool `yaml:"tools_breakpoint,omitempty"`
	HistoryEveryN    *int  `yaml:"history_every_n,omitempty"` // history breakpoint budget (≤ remaining of 4); 0 = none
	MinCacheTokens   *int  `yaml:"min_cache_tokens,omitempty"`
}

type ProviderConfig struct {
	Type    string            `yaml:"type"`
	APIKey  string            `yaml:"api_key"`
	BaseURL string            `yaml:"base_url"`
	Models  map[string]string `yaml:"models"`
	Headers map[string]string `yaml:"headers"`
}

type ProviderError string

type ReasoningPart struct {
	Type             string                 `json:"type"`
	Text             string                 `json:"text"`
	ProviderMetadata map[string]interface{} `json:"provider_metadata,omitempty"`
}

type Session = session.Session

type SessionLister interface {
	ListSessions() []string
}

type SessionOption = session.Option

type Skill struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Prompt      string `json:"prompt"`
}

type SkillsConfig struct {
	Path     string `yaml:"path"`
	AutoLoad bool   `yaml:"auto_load"`
}

type SourceURLPart struct {
	Type             string                 `json:"type"`
	SourceID         string                 `json:"source_id"`
	URL              string                 `json:"url"`
	Title            string                 `json:"title,omitempty"`
	ProviderMetadata map[string]interface{} `json:"provider_metadata,omitempty"`
}

type StepStartPart struct {
	Type string `json:"type"`
}

type StreamEvent = session.Event

type StreamEventSender interface {
	SendStreamEvent(sessionID string, event interface{})
}

type TextPart struct {
	Type string `json:"type"`
	Text string `json:"text"`
}

type TokenCache struct {
	Read  int `json:"read"`
	Write int `json:"write"`
}

type TokenInfo struct {
	Input     int        `json:"input"`
	Output    int        `json:"output"`
	Reasoning int        `json:"reasoning"`
	Cache     TokenCache `json:"cache"`
}

type ToolCallInfo = session.ToolCallInfo

type ToolConfig struct {
	Profile                     string   `yaml:"profile"`
	Allowed                     []string `yaml:"allowed"`
	ApprovalRequired            []string `yaml:"approval_required"`
	Denied                      []string `yaml:"denied"`
	MaxToolParallelism          int      `yaml:"max_tool_parallelism,omitempty"`            // 0=默认 max(4, GOMAXPROCS*2)；>0 用该值
	StreamBufferSize            int      `yaml:"stream_buffer_size,omitempty"`              // 0=默认 50
	ResultLimiterMaxBytes       int      `yaml:"result_limiter_max_bytes,omitempty"`        // 0=默认 120_000
	ResultLimiterMaxStringBytes int      `yaml:"result_limiter_max_string_bytes,omitempty"` // 0=默认 60_000
	// ToolSearchEnabled 控制是否注入 tool_search 工具并启用 Deferred 工具的
	// 延迟发现（E2）。默认 true。
	ToolSearchEnabled bool `yaml:"tool_search_enabled,omitempty"`
	// MCPDeferred 为 true 时，所有 MCP 工具以 ExposureDeferred 注册（不进初始
	// 工具列表，靠 tool_search 发现）。默认 false 灰度，稳定后翻 true（§2.5）。
	MCPDeferred bool `yaml:"mcp_deferred,omitempty"`
	// MaxDiscoveredTools 每个 session 可通过 tool_search 发现/注入的 Deferred
	// 工具上限（R1）。0 = 默认 32；<0 = 不设上限。
	MaxDiscoveredTools int `yaml:"max_discovered_tools,omitempty"`
}

type ToolContext struct {
	SessionID string
	MessageID string
	Agent     string
	Abort     <-chan struct{}
	CallID    string
	Extra     map[string]interface{}
	Messages  []MessageInfo
	Metadata  func(title string, metadata map[string]interface{})
	Ask       func(request PermissionRequest) error
}

type ToolDefinition struct {
	ID          string
	Name        string
	Description string
	Parameters  map[string]interface{}
	Metadata    ToolMetadataExt
}

type ToolExecutor func(args map[string]interface{}, ctx ToolContext) (*ToolResult, error)

type ToolInvocation struct {
	State      ToolInvocationState    `json:"state"`
	Step       int                    `json:"step,omitempty"`
	ToolCallID string                 `json:"tool_call_id"`
	ToolName   string                 `json:"tool_name"`
	Args       map[string]interface{} `json:"args,omitempty"`
	Result     string                 `json:"result,omitempty"`
}

type ToolInvocationPart struct {
	Type           string         `json:"type"`
	ToolInvocation ToolInvocation `json:"tool_invocation"`
}

type ToolInvocationState string

type ToolMeta struct {
	Title    string                 `json:"title"`
	Snapshot string                 `json:"snapshot,omitempty"`
	Time     ToolMetaTime           `json:"time"`
	Extra    map[string]interface{} `json:"extra,omitempty"`
}

type ToolMetaTime struct {
	Start int64 `json:"start"`
	End   int64 `json:"end,omitempty"`
}

type ToolMetadataExt struct {
	Title       string                 `json:"title,omitempty"`
	Snapshot    string                 `json:"snapshot,omitempty"`
	Truncated   bool                   `json:"truncated,omitempty"`
	OutputPath  string                 `json:"output_path,omitempty"`
	Attachments []FileAttachment       `json:"attachments,omitempty"`
	Extra       map[string]interface{} `json:"extra,omitempty"`
}

type ToolResult struct {
	Title       string                 `json:"title"`
	Metadata    map[string]interface{} `json:"metadata"`
	Output      string                 `json:"output"`
	Attachments []FileAttachment       `json:"attachments,omitempty"`
}

type ToolState struct {
	Status   string                 `json:"status"`
	Input    map[string]interface{} `json:"input,omitempty"`
	Output   string                 `json:"output,omitempty"`
	Metadata map[string]interface{} `json:"metadata,omitempty"`
	Title    string                 `json:"title,omitempty"`
	Time     *ToolTime              `json:"time,omitempty"`
}

type ToolTime struct {
	Start int64 `json:"start"`
	End   int64 `json:"end,omitempty"`
}

type TraceConfig struct {
	Enabled               bool   `yaml:"enabled"`
	Dir                   string `yaml:"dir,omitempty"` // default "./dino_sessions/traces"
	QueueSize             int    `yaml:"queue_size,omitempty"`
	FlushIntervalMs       int    `yaml:"flush_interval_ms,omitempty"`
	CaptureFullMessages   bool   `yaml:"capture_full_messages,omitempty"`
	CaptureFullToolOutput bool   `yaml:"capture_full_tool_output,omitempty"`
	CaptureChunks         bool   `yaml:"capture_chunks,omitempty"`
}

type TurnCanceledError = session.TurnCanceledError

type TurnObservation = session.TurnObservation

type TurnSessionClosedError = session.TurnSessionClosedError

type Usage = session.Usage