router

type Config struct {
	// Model 分类模型（一次 GenerateJSON 调用；用快模型即可）。
	Model model.BaseChatModel
	// ModelName 分类调用记账标识。
	ModelName string
	// Routes 路由表（≥1 条；Name 唯一）。
	Routes []Route
	// MinConfidence 置信度下限（0~1；低于则走 Fallback。0 = 不设门槛）。
	MinConfidence float64
	// Fallback 兜底处理链（nil = 低置信/无法分类时报错）。
	Fallback func(ctx context.Context, input string, reason string) (string, error)
	// Slots 意图槽位（nil = 纯选路：提示词与解析保持原样，模型多给的 slots 一律丢弃）。
	Slots []SlotSpec

	// DecisionFace 决策面（System One 等非自回归判定模型；nil = 不启用）。
	//
	// 启用后**先问决策面**：达门槛即采纳（省一次 LLM 分类调用）；未达门槛 / 端点
	// 故障 ⇒ 回落 LLM 面（fail-open：判定面是加速件，不得阻断主链）。
	// 不启用时行为与从前**逐字节一致**。
	DecisionFace DecisionFace
	// DecisionMinConfidence 决策面置信门槛（0 = 不设；0-1）。未达门槛 ⇒ 回落 LLM 面。
	//
	// 注意口径**随候选集规模变化**（判定模型的置信度是分布集中度：候选越多、同一
	// p_top 折出的置信度越低）⇒ 门槛须随候选集标定，不能跨候选集移植。
	DecisionMinConfidence float64
	// DecisionShadow 影子模式：调用决策面但**只记不采**（结果进 DecisionObserver，
	// 行为面零变更）——上线前量一致率与延迟的标准姿势。
	DecisionShadow bool
	// DecisionObserver 决策面结果观察钩子（nil = 不观察）。每次决策面调用后回调一次
	// （采纳时 err=nil；未过门槛/故障时 err 非 nil；影子模式时 err=影子标记）。
	DecisionObserver DecisionObserver
}

type Decision struct {
	Route      string  `json:"route"`
	Confidence float64 `json:"confidence"`
	Reason     string  `json:"reason"`
	// Slots 槽位提取结果（仅含已配置槽位；未配置/模型未给 = nil）。
	Slots map[string]string `json:"slots,omitempty"`
	// Source 判定来源：llm（**零值即 llm**，向后兼容既有消费方）| decision
	// （决策面，System One 等非自回归判定模型）。
	Source string `json:"source,omitempty"`
}

type DecisionFace interface {
	// Classify 用给定候选集与槽位规格做一次判定。
	//
	// state 是待判定的原始输入；routes/slots 是本包的候选集与槽位规格
	// （实现方据此组题）。返回的 Decision 只需填 Route/Confidence/Slots。
	Classify(ctx context.Context, state string, routes []Route, slots []SlotSpec) (Decision, error)
}

type DecisionObserver func(d Decision, err error)

type Route struct {
	// Name 路由名（分类目标词，须唯一；小写短横线风格，如 "bug-fix"）。
	Name string
	// Description 意图描述（分类依据——写清"什么样的问题走这条"）。
	Description string
	// Handle 处理链（任意编排：单轮生成 / ReAct / P&E / 纯函数）。
	Handle func(ctx context.Context, input string) (string, error)
}

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

type SlotSpec struct {
	// Name 槽位名（回复 JSON slots 对象的 key；短横线/字母风格，如 "plan"）。
	Name string
	// Description 取值语义（合法值与判据，值一律字符串，如 "true"/"false"）。
	Description string
}