agent

type ChainContext struct {
	Agent        *agentmdl.Agent
	Conversation *apiconv.Conversation
	Context      map[string]interface{}
	UserID       string
	ParentTurn   *memory.TurnMeta
	Output       struct{ Content, Model, MessageID, Error string }
	// Per-request controls
	AllowedChains []string
	DisableChains bool
}

type ConversationMetadata struct {
	Tools   []string                   `json:"tools,omitempty"`
	Context map[string]interface{}     `json:"context,omitempty"`
	Extra   map[string]json.RawMessage `json:"-"`
}

type HistoryResult struct {
	History          prompt.History
	Elicitation      []*prompt.Message
	Overflow         bool
	MaxOverflowBytes int
}

type Option func(*Service)

type QueryInput struct {
	RequestTime time.Time `json:"requestTime,omitempty"`

	// ConversationID is an optional identifier for the conversation session.
	// If provided, conversation history will be tracked and reused.
	ConversationID       string `json:"conversationId,omitempty"`
	ParentConversationID string `json:"parentConversationId,omitempty"`
	// Optional client-supplied identifier for the user message. When empty the
	// service will generate a UUID.
	MessageID   string               `json:"messageId,omitempty"`
	AgentID     string               `json:"agentId"` // Agent ID to use
	UserId      string               `json:"userId"`
	Agent       *agentmdl.Agent      `json:"agent"` // Agent to use (alternative to agentId)
	Query       string               `json:"query"` // The query to submit
	Attachments []*prompt.Attachment `json:"attachments,omitempty"`

	MaxResponseSize int    `json:"maxResponseSize"` // Maximum size of the response in bytes
	MaxDocuments    int    `json:"maxDocuments"`    // Maximum number of documents to retrieve
	IncludeFile     bool   `json:"includeFile"`     // Whether to include complete file content
	EmbeddingModel  string `json:"embeddingModel"`  // Find to use for embeddings

	// Optional runtime overrides (single-turn)
	ModelOverride string   `json:"model,omitempty"` // llm model name
	ToolsAllowed  []string `json:"tools,omitempty"` // allow-list for tools (empty = default)
	// ToolBundles selects global tool bundles by id for this turn. When provided,
	// bundles are expanded into a concrete tool allow-list sent to the model.
	ToolBundles []string `json:"toolBundles,omitempty"`
	// AutoSelectTools enables tool-bundle auto selection for this turn when the caller did
	// not explicitly provide tools or bundles.
	AutoSelectTools *bool                  `json:"autoSelectTools,omitempty"`
	Context         map[string]interface{} `json:"context,omitempty"`
	// ModelPreferences optionally overrides or hints model selection
	// preferences for this turn. When nil, the agent's configured
	// ModelSelection.Preferences are used.
	ModelPreferences *llm.ModelPreferences `json:"modelPreferences,omitempty"`

	Transcript conversation.Transcript `json:"transcript,omitempty"`

	// ElicitationMode controls how missing-input requests are handled.
	ElicitationMode string `json:"elicitationMode,omitempty" yaml:"elicitationMode,omitempty"`

	AutoSummarize *bool `json:"autoSummarize,omitempty"`

	AllowedChains []string `json:"allowedChains,omitempty"` //

	DisableChains bool `json:"disableChains,omitempty"`

	ToolCallExposure *agentmdl.ToolCallExposure `json:"toolCallExposure,omitempty"`

	// ReasoningEffort optionally overrides agent-level Reasoning.Effort for this turn.
	// Valid values (OpenAI o-series): low | medium | high.
	ReasoningEffort *string `json:"reasoningEffort,omitempty"`

	// ScheduleId links this query to the schedule that triggered it.
	// When set, the created conversation will have schedule_id populated.
	ScheduleId string `json:"scheduleId,omitempty"`

	// IsNewConversation indicates if this is a new conversation without prior history.
	IsNewConversation bool `json:"-"`
	// SkipInitialUserMessage tells Query to reuse an already persisted starter
	// user message (e.g. queued turn) instead of adding a duplicate.
	SkipInitialUserMessage bool `json:"-"`
	// AutoSelected reports whether the runtime auto-routed the agent for this turn.
	AutoSelected bool `json:"-"`
	// RoutingReason captures the auto-routing reason when AutoSelected is true.
	RoutingReason string `json:"-"`
}

type QueryOutput struct {
	ConversationID string            `json:"conversationId,omitempty"`
	Agent          *agentmdl.Agent   `json:"agent"`                 // Agent used for the query
	Content        string            `json:"content"`               // Generated content from the agent
	Elicitation    *plan.Elicitation `json:"elicitation,omitempty"` // structured missing input request
	Plan           *plan.Plan        `json:"plan,omitempty"`        // current execution plan (optional)
	Usage          *usage.Aggregator `json:"usage,omitempty"`
	Model          string            `json:"model,omitempty"`
	MessageID      string            `json:"messageId,omitempty"`
	Warnings       []string          `json:"warnings,omitempty"`
	// contains filtered or unexported fields
}

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

type ToolExecutionsResult struct {
	Calls            []*llm.ToolCall
	Overflow         bool
	MaxOverflowBytes int
}

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

type WatchdogOption func(*Watchdog)