config

type AgentAutoSelectionDefaults struct {
	// Model is the model used for routing decisions. When empty, runtime falls back
	// to the conversation default model or Defaults.Model.
	Model string `yaml:"model,omitempty" json:"model,omitempty"`
	// Prompt optionally overrides the default system prompt used by the router.
	// The prompt MUST instruct the LLM to output one of:
	//   {"action":"route","agentId":"<id>"}
	//   {"action":"answer","text":"<capability answer>"}
	//   {"action":"clarify","question":"<clarification>"}
	// (See `agentRouterSystemPrompt` for the built-in default.)
	//
	// Capability detection is the LLM's responsibility, not a pattern-match
	// heuristic — `action: "answer"` is how the router signals "this is a
	// workspace-capability question; here is the answer directly." This
	// eliminates the prior hardcoded `isCapabilityDiscoveryQuery` shortcut
	// and unifies the auto-selection intake into a single LLM call.
	Prompt string `yaml:"prompt,omitempty" json:"prompt,omitempty"`
	// OutputKey controls the JSON field name the classifier should output.
	// Examples: "agentId" (default), "agent_id".
	OutputKey string `yaml:"outputKey,omitempty" json:"outputKey,omitempty"`
	// TimeoutSec caps how long agent auto-selection classification may run.
	// When zero, runtime applies a conservative default.
	TimeoutSec int `yaml:"timeoutSec,omitempty" json:"timeoutSec,omitempty"`
}

type AsyncDefaults = wsconfig.WorkspaceConfig

type Defaults struct {
	AppName    string
	AppIconRef string
	Model      string
	Embedder   string
	Agent      string
	Skills     SkillsDefaults    `yaml:"skills,omitempty" json:"skills,omitempty"`
	Reporting  ReportingDefaults `yaml:"reporting,omitempty" json:"reporting,omitempty"`
	// RuntimeRoot allows separating runtime state (db, snapshots, indexes) from the workspace.
	// Supports ${workspaceRoot}. When empty, defaults to ${workspaceRoot}.
	RuntimeRoot string `yaml:"runtimeRoot,omitempty" json:"runtimeRoot,omitempty"`
	// StatePath overrides the runtime state root (used by cookies/tokens).
	// Supports ${workspaceRoot} and ${runtimeRoot}. When empty, defaults to ${runtimeRoot}/state.
	StatePath string `yaml:"statePath,omitempty" json:"statePath,omitempty"`
	// DBPath overrides the SQLite database file path when AGENTLY_DB_* is not set.
	// Supports ${workspaceRoot} and ${runtimeRoot}. When empty, defaults to ${runtimeRoot}/db/agently.db.
	DBPath string `yaml:"dbPath,omitempty" json:"dbPath,omitempty"`

	// ---- Agent routing defaults (optional) -------------------------
	// When Agent == "auto", the runtime may use these settings to pick a concrete
	// agent for the turn using an LLM-based classifier.
	AgentAutoSelection AgentAutoSelectionDefaults `yaml:"agentAutoSelection,omitempty" json:"agentAutoSelection,omitempty"`

	// ---- Tool routing defaults (optional) --------------------------
	// When enabled, the runtime may select tool bundles for the turn based on the
	// user request when the caller did not explicitly provide tools/bundles.
	ToolAutoSelection ToolAutoSelectionDefaults `yaml:"toolAutoSelection,omitempty" json:"toolAutoSelection,omitempty"`
	// ToolApproval defines global runtime tool execution approval behavior.
	// Applies when callers do not supply per-request tool allow-list overrides.
	ToolApproval ToolApprovalDefaults `yaml:"toolApproval,omitempty" json:"toolApproval,omitempty"`

	// ---- Conversation summary defaults (optional) -------------------
	// When empty the runtime falls back to hard-coded defaults.
	SummaryModel  string `yaml:"summaryModel" json:"summaryModel"`
	SummaryPrompt string `yaml:"summaryPrompt" json:"summaryPrompt"`
	SummaryLastN  int    `yaml:"summaryLastN" json:"summaryLastN"`
	// CapabilityPrompt overrides the system prompt used for capability discovery responses.
	CapabilityPrompt string `yaml:"capabilityPrompt" json:"capabilityPrompt"`

	// ---- Tool-call result controls (grouped) ---------------------
	PreviewSettings PreviewSettings `yaml:"previewSettings" json:"previewSettings"`

	// ---- Prompt-history projection -------------------------------
	Projection Projection `yaml:"projection,omitempty" json:"projection,omitempty"`

	ToolCallMaxResults int `yaml:"toolCallMaxResults" json:"toolCallMaxResults"`

	// ---- Execution timeouts -------------------------------------
	// ToolCallTimeoutSec sets the default per-tool execution timeout in seconds.
	// When zero or missing, runtime falls back to a built-in default.
	ToolCallTimeoutSec int `yaml:"toolCallTimeoutSec,omitempty" json:"toolCallTimeoutSec,omitempty"`
	// ElicitationTimeoutSec caps how long the agent waits for an elicitation
	// (assistant- or tool-originated) before auto-declining. When zero, no
	// special timeout is applied (waits until the turn/request is canceled).
	ElicitationTimeoutSec int `yaml:"elicitationTimeoutSec,omitempty" json:"elicitationTimeoutSec,omitempty"`

	// ToolExecutionProtection is a default-disabled exact-tool at-most-once guard.
	ToolExecutionProtection ToolExecutionProtectionDefaults `yaml:"toolExecutionProtection,omitempty" json:"toolExecutionProtection,omitempty"`

	// ---- Match defaults (optional) -------------------------------
	Match MatchDefaults `yaml:"match" json:"match"`

	// ---- Resources defaults (optional) ---------------------------
	Resources ResourcesDefaults `yaml:"resources,omitempty" json:"resources,omitempty"`

	// ---- Async defaults (optional) -------------------------------
	// Operator-tunable GC cadence and narrator LLM timeout for the
	// async subsystem. Empty / absent → built-in package defaults
	// remain in effect. Applied at bootstrap via wsconfig.Apply.
	Async *AsyncDefaults `yaml:"async,omitempty" json:"async,omitempty"`
	// contains filtered or unexported fields
}

type MatchDefaults struct {
	// MaxFiles is the default per-location cap used by auto/full decision
	// when a knowledge/MCP entry does not specify MaxFiles. When zero,
	// the runtime falls back to hard-coded default (5).
	MaxFiles int `yaml:"maxFiles" json:"maxFiles"`
}

type PreviewSettings struct {
	Limit int `yaml:"limit" json:"limit"`

	AgedLimit int `yaml:"agedLimit" json:"agedLimit"`

	// ToolResultLimit optionally caps preview size specifically for tool-result
	// messages. When zero or negative, the general Limit/AgedLimit rules apply.
	ToolResultLimit int `yaml:"toolResultLimit,omitempty" json:"toolResultLimit,omitempty"`

	// How far back until we switch the UI to an aged preview.
	AgedAfterSteps int `yaml:"agedAfterSteps" json:"agedAfterSteps"`

	SummarizeChunk int    `yaml:"summarizeChunk" json:"summarizeChunk"`
	MatchChunk     int    `yaml:"matchChunk" json:"matchChunk"`
	SummaryModel   string `yaml:"summaryModel" json:"summaryModel"`
	EmbeddingModel string `yaml:"embeddingModel" json:"embeddingModel"`
	// Optional system guide document (path or URL) injected when overflow occurs.
	SystemGuidePath string `yaml:"systemGuidePath" json:"systemGuidePath"`
	// SummaryThresholdBytes controls when message:summarize is
	// exposed for overflowed messages. When zero or negative, any
	// overflowed message may use summarize.
	SummaryThresholdBytes int `yaml:"summaryThresholdBytes,omitempty" json:"summaryThresholdBytes,omitempty"`
}

type Projection struct {
	Relevance            *RelevanceProjection  `yaml:"relevance,omitempty" json:"relevance,omitempty"`
	ToolCallSupersession *ToolCallSupersession `yaml:"toolCallSupersession,omitempty" json:"toolCallSupersession,omitempty"`
}

type RelevanceProjection struct {
	Enabled              *bool           `yaml:"enabled,omitempty" json:"enabled,omitempty"`
	ProtectedRecentTurns *int            `yaml:"protectedRecentTurns,omitempty" json:"protectedRecentTurns,omitempty"`
	TokenThreshold       *int            `yaml:"tokenThreshold,omitempty" json:"tokenThreshold,omitempty"`
	ChunkSize            *int            `yaml:"chunkSize,omitempty" json:"chunkSize,omitempty"`
	MaxConcurrency       *int            `yaml:"maxConcurrency,omitempty" json:"maxConcurrency,omitempty"`
	Model                *string         `yaml:"model,omitempty" json:"model,omitempty"`
	Prompt               *binding.Prompt `yaml:"prompt,omitempty" json:"prompt,omitempty"`
}

type ReportingDefaults struct {
	Enabled            bool                                `yaml:"enabled,omitempty" json:"enabled,omitempty"`
	QueueIntervalMs    int                                 `yaml:"queueIntervalMs,omitempty" json:"queueIntervalMs,omitempty"`
	QueueBatchLimit    int                                 `yaml:"queueBatchLimit,omitempty" json:"queueBatchLimit,omitempty"`
	Store              ReportingStoreDefaults              `yaml:"store,omitempty" json:"store,omitempty"`
	TransitionalWithUI ReportingTransitionalWithUIDefaults `yaml:"transitionalWithUI,omitempty" json:"transitionalWithUI,omitempty"`
}

type ReportingStoreDefaults struct {
	Backend      string `yaml:"backend,omitempty" json:"backend,omitempty"`
	ConnectorRef string `yaml:"connectorRef,omitempty" json:"connectorRef,omitempty"`
}

type ReportingTransitionalWithUIDefaults struct {
	Admission            string `yaml:"admission,omitempty" json:"admission,omitempty"`
	Persistence          string `yaml:"persistence,omitempty" json:"persistence,omitempty"`
	ExportFromRun        string `yaml:"exportFromRun,omitempty" json:"exportFromRun,omitempty"`
	Orchestration        string `yaml:"orchestration,omitempty" json:"orchestration,omitempty"`
	ConversationAdoption string `yaml:"conversationAdoption,omitempty" json:"conversationAdoption,omitempty"`
}

type ResourceRoot struct {
	ID          string `yaml:"id,omitempty" json:"id,omitempty"`
	URI         string `yaml:"uri,omitempty" json:"uri,omitempty"`
	UpstreamRef string `yaml:"upstreamRef,omitempty" json:"upstreamRef,omitempty"`
	SyncEnabled *bool  `yaml:"syncEnabled,omitempty" json:"syncEnabled,omitempty"`
	MinInterval int    `yaml:"minIntervalSeconds,omitempty" json:"minIntervalSeconds,omitempty"`
	Batch       int    `yaml:"batch,omitempty" json:"batch,omitempty"`
	Shadow      string `yaml:"shadow,omitempty" json:"shadow,omitempty"`
	Force       *bool  `yaml:"force,omitempty" json:"force,omitempty"`
}

type ResourceUpstream struct {
	Name               string `yaml:"name,omitempty" json:"name,omitempty"`
	Driver             string `yaml:"driver,omitempty" json:"driver,omitempty"`
	DSN                string `yaml:"dsn,omitempty" json:"dsn,omitempty"`
	Shadow             string `yaml:"shadow,omitempty" json:"shadow,omitempty"`
	Batch              int    `yaml:"batch,omitempty" json:"batch,omitempty"`
	Force              bool   `yaml:"force,omitempty" json:"force,omitempty"`
	Enabled            *bool  `yaml:"enabled,omitempty" json:"enabled,omitempty"`
	MinIntervalSeconds int    `yaml:"minIntervalSeconds,omitempty" json:"minIntervalSeconds,omitempty"`
}

type ResourceUpstreamStore struct {
	Driver             string `yaml:"driver,omitempty" json:"driver,omitempty"`
	DSN                string `yaml:"dsn,omitempty" json:"dsn,omitempty"`
	Shadow             string `yaml:"shadow,omitempty" json:"shadow,omitempty"`
	Batch              int    `yaml:"batch,omitempty" json:"batch,omitempty"`
	Force              bool   `yaml:"force,omitempty" json:"force,omitempty"`
	MinIntervalSeconds int    `yaml:"minIntervalSeconds,omitempty" json:"minIntervalSeconds,omitempty"`
}

type ResourcesDefaults struct {
	// Locations are root URIs or paths (relative to workspace) such as
	// "documents/", "file:///abs/path", or "mcp:server:/prefix".
	Locations []string `yaml:"locations,omitempty" json:"locations,omitempty"`
	// Roots define resource roots with optional upstream bindings for local/workspace locations.
	Roots []ResourceRoot `yaml:"roots,omitempty" json:"roots,omitempty"`
	// Upstreams define upstream databases for local/workspace resource sync.
	Upstreams []ResourceUpstream `yaml:"upstreams,omitempty" json:"upstreams,omitempty"`
	// UpstreamStore defines the default upstream used when roots omit upstreamRef.
	UpstreamStore *ResourceUpstreamStore `yaml:"upstreamStore,omitempty" json:"upstreamStore,omitempty"`
	// IndexPath controls where Embedius stores local indexes. Supports
	// ${workspaceRoot} and ${user} macros. If empty, defaults to
	// ${workspaceRoot}/index/${user}.
	IndexPath string `yaml:"indexPath,omitempty" json:"indexPath,omitempty"`
	// SnapshotPath controls where MCP snapshot caches are stored. Supports
	// ${workspaceRoot} and ${user} macros. If empty, defaults to
	// ${workspaceRoot}/snapshots.
	SnapshotPath string `yaml:"snapshotPath,omitempty" json:"snapshotPath,omitempty"`
	// TrimPath optionally trims this prefix from presented URIs.
	TrimPath string `yaml:"trimPath,omitempty" json:"trimPath,omitempty"`
	// SummaryFiles lookup order for root descriptions.
	SummaryFiles []string `yaml:"summaryFiles,omitempty" json:"summaryFiles,omitempty"`
	// DescribeMCP enables MCP description fetches for resources.roots when
	// no description is provided by config/metadata.
	DescribeMCP bool `yaml:"describeMCP,omitempty" json:"describeMCP,omitempty"`
	// UpstreamSyncConcurrency controls parallel root syncs for MCP upstreams.
	UpstreamSyncConcurrency int `yaml:"upstreamSyncConcurrency,omitempty" json:"upstreamSyncConcurrency,omitempty"`
	// MatchConcurrency controls parallel match execution across roots.
	MatchConcurrency int `yaml:"matchConcurrency,omitempty" json:"matchConcurrency,omitempty"`
	// IndexAsync enables background indexing for resource matches.
	IndexAsync *bool `yaml:"indexAsync,omitempty" json:"indexAsync,omitempty"`
}

type SkillsDefaults struct {
	Roots []string `yaml:"roots,omitempty" json:"roots,omitempty"`
	Model string   `yaml:"model,omitempty" json:"model,omitempty"`
}

type SupersessionLimit struct {
	// History is the max matching results per key across all prior turns
	// T(LastCheckpoint)..T(N-1). Default: 1 (only the newest survives).
	History *int `yaml:"history,omitempty" json:"history,omitempty"`
	// Turn is the max matching results per key within the current turn TN.
	// Default: 2 (keep last 2, suppress K-2 earliest).
	Turn *int `yaml:"turn,omitempty" json:"turn,omitempty"`
}

type ToolApprovalDefaults struct {
	// Mode: auto | ask | deny | best_path
	Mode string `yaml:"mode,omitempty" json:"mode,omitempty"`
	// AllowList optionally constrains executable tools to this set.
	AllowList []string `yaml:"allowList,omitempty" json:"allowList,omitempty"`
	// BlockList blocks specific tool names regardless of mode.
	BlockList []string `yaml:"blockList,omitempty" json:"blockList,omitempty"`
}

type ToolAutoSelectionDefaults struct {
	// Enabled turns on auto tool selection when the caller did not specify tools.
	Enabled bool `yaml:"enabled,omitempty" json:"enabled,omitempty"`
	// Model is the model used for routing decisions. When empty, runtime falls back
	// to the conversation default model or Defaults.Model.
	Model string `yaml:"model,omitempty" json:"model,omitempty"`
	// Prompt optionally overrides the default system prompt used by the router.
	Prompt string `yaml:"prompt,omitempty" json:"prompt,omitempty"`
	// OutputKey controls the JSON field name the classifier should output.
	// Example: "toolBundles" (default).
	OutputKey string `yaml:"outputKey,omitempty" json:"outputKey,omitempty"`
	// MaxBundles caps the number of bundles the router may select.
	// When zero, a small default is applied.
	MaxBundles int `yaml:"maxBundles,omitempty" json:"maxBundles,omitempty"`
	// TimeoutSec caps how long tool auto-selection classification may run.
	// When zero, runtime applies a conservative default.
	TimeoutSec int `yaml:"timeoutSec,omitempty" json:"timeoutSec,omitempty"`
}

type ToolCallSupersession struct {
	// Enabled controls whether supersession is applied. Default: true.
	Enabled *bool `yaml:"enabled,omitempty" json:"enabled,omitempty"`
	// Limit controls how many matching results per supersession key are
	// retained in each scope.
	Limit *SupersessionLimit `yaml:"limit,omitempty" json:"limit,omitempty"`
}

type ToolExecutionProtectionDefaults struct {
	Enabled bool                          `yaml:"enabled,omitempty" json:"enabled,omitempty"`
	Rules   []ToolExecutionProtectionRule `yaml:"rules,omitempty" json:"rules,omitempty"`
}

type ToolExecutionProtectionRule struct {
	ID                string                          `yaml:"id" json:"id"`
	Tool              string                          `yaml:"tool" json:"tool"`
	Mode              string                          `yaml:"mode" json:"mode"`
	SemanticArguments *ToolExecutionSemanticArguments `yaml:"semanticArguments,omitempty" json:"semanticArguments,omitempty"`
}

type ToolExecutionSemanticArguments struct {
	Fields        []string `yaml:"fields,omitempty" json:"fields,omitempty"`
	ExcludeFields []string `yaml:"excludeFields,omitempty" json:"excludeFields,omitempty"`
}