agent

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

type ClassifierResult struct {
	Action         string
	AgentID        string
	Answer         string
	Question       string
	PlannerTrigger string
}

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

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

type Option func(*Service)

type PlannerPassTrace struct {
	ConversationID  string
	TurnID          string
	Attempt         int
	Validated       bool
	StrategyFamily  string
	BaseProfiles    []string
	ToolBundles     []string
	TemplateID      string
	EvidenceCount   int
	ExecutionOrder  []string
	Guards          []string
	ValidatorErrors []planner.ValidationError
}

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"`
	// ConversationTitle is an optional title for new conversations. When empty
	// the runtime may derive one from the query or leave it unset for
	// autoSummarize to fill in after the first turn.
	ConversationTitle string `json:"conversationTitle,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"`                  // Internal query/prompt submitted to the runtime
	DisplayQuery string                `json:"displayQuery,omitempty"` // Display-safe user task persisted in transcript/UI
	Attachments  []*binding.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"`
	Runtime         *agruntime.Context     `json:"runtime,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"`

	// TemplateId optionally pre-selects an output template for this turn.
	// When set, the runtime will attempt to inject the template document before
	// the LLM starts so the worker doesn't need to call template:get explicitly.
	// Populated by the llm/agents runtime when a PromptProfile specifies a template.
	TemplateId string `json:"templateId,omitempty"`

	// PromptProfileId optionally selects a prompt profile for this turn.
	// For direct agent turns this is typically populated by intake/routing,
	// not by llm/agents child-run wiring.
	PromptProfileId string `json:"promptProfileId,omitempty"`
	// ParallelToolCalls optionally overrides the agent-level parallel tool
	// execution preference for this specific turn.
	ParallelToolCalls *bool `json:"parallelToolCalls,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    *execution.Elicitation               `json:"elicitation,omitempty"` // structured missing input request
	Plan           *execution.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"`
	Projection     *runtimeprojection.ContextProjection `json:"projection,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)