// // Copyright 2026 The InfiniFlow Authors. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // // Package component — Switch component (T2, plan §2.11.3 row 7). // // Switch is a multi-condition router implemented in pure Go (no eino // Lambda dependency). It walks a list of AND/OR-combined condition // groups against the current *CanvasState, picks the first matching // group's downstream cpn_id, and returns it as outputs["_next"]. The // downstream cpn_id for a matching group is taken from the optional // "to" field; if absent, the P0 fallback is the index-based // "matched_" naming used in the spec's example assertions. // // Mirrors the Python agent/component/switch.py behavior. The Phase 5 // eino `compose.NewGraphMultiBranch` integration (per plan §2.11.6 // entry for Switch) is a thinner pass-through: the hard routing // decision lives here, MultiBranch just wires the edges. package component import ( "context" "fmt" "maps" "strconv" "ragflow/internal/agent/runtime" ) const componentNameSwitch = "Switch" // SwitchComponent implements the Switch routing node. It is stateless // across invocations: the inputs map carries everything it needs. type SwitchComponent struct { name string } // NewSwitchComponent constructs a Switch component. params is unused // in P0 (Switch config lives in the inputs map at Invoke time). func NewSwitchComponent(_ map[string]any) (Component, error) { return &SwitchComponent{name: componentNameSwitch}, nil } // Name returns the registered component name. func (s *SwitchComponent) Name() string { return s.name } // Invoke evaluates the conditions list in order, returns the first // matching group's downstream cpn_id at outputs["_next"]. If no group // matches, outputs["_next"] = inputs["default"] (a free-form string — // Phase 5 will resolve it to a real cpn_id via the eino multi-branch // wiring). Unknown / empty inputs are tolerated: an absent "conditions" // list yields outputs["_next"] = inputs["default"]. func (s *SwitchComponent) Invoke(ctx context.Context, inputs map[string]any) (map[string]any, error) { state, _, err := runtime.GetStateFromContext[*runtime.CanvasState](ctx) if err != nil { return nil, fmt.Errorf("Switch: %w", err) } if state == nil { return nil, fmt.Errorf("Switch: nil canvas state") } defaultNext, _ := inputs["default"].(string) if raw, ok := inputs["conditions"].([]any); ok { for i, item := range raw { group, ok := item.(map[string]any) if !ok { continue } matched, evalErr := evaluateGroup(group, state) if evalErr != nil { return nil, fmt.Errorf("Switch: condition[%d]: %w", i, evalErr) } if !matched { continue } next, hasTo := group["to"].(string) if !hasTo || next == "" { next = "matched_" + strconv.Itoa(i) } return map[string]any{"_next": next}, nil } } return map[string]any{"_next": defaultNext}, nil } // Stream is a synchronous facade over Invoke for P0. Switch is a // routing decision, not a stream of partial results; the channel // receives one payload and closes. func (s *SwitchComponent) Stream(ctx context.Context, inputs map[string]any) (<-chan map[string]any, error) { out, err := s.Invoke(ctx, inputs) if err != nil { return nil, err } ch := make(chan map[string]any, 1) ch <- out close(ch) return ch, nil } // Inputs returns the public parameter surface. func (s *SwitchComponent) Inputs() map[string]string { return map[string]string{ "conditions": "Ordered list of condition groups; each is {op: \"and\"|\"or\", to?: cpn_id, clauses: [{left, op, right?}]}.", "default": "Downstream cpn_id used when no condition matches.", } } // Outputs returns the chosen cpn_id. func (s *SwitchComponent) Outputs() map[string]string { return map[string]string{ "_next": "The cpn_id of the downstream node to route to.", } } // evaluateGroup applies the group's op (and/or) to its clauses and // returns true if the group matches. It is the lock-free inner of // Switch.Invoke; caller must not hold state.mu. func evaluateGroup(group map[string]any, state *runtime.CanvasState) (bool, error) { op, _ := group["op"].(string) clauses, _ := group["clauses"].([]any) if op == "" { op = "and" } if len(clauses) == 0 { // An empty group is vacuously true (matches). return true, nil } for i, raw := range clauses { c, ok := raw.(map[string]any) if !ok { return false, fmt.Errorf("clause[%d] not a map", i) } matched, err := evaluateClause(c, state) if err != nil { return false, fmt.Errorf("clause[%d]: %w", i, err) } if op == "or" && matched { return true, nil } if op == "and" && !matched { return false, nil } } // For "and" with no early false: matched. For "or" with no early true: not matched. return op == "and", nil } // evaluateClause resolves a single clause. left is a {{...}} reference // (passed through runtime.ResolveTemplate); op is one of // "==", "!=", ">", "<", "contains", "empty". The "empty" operator // ignores right. func evaluateClause(clause map[string]any, state *runtime.CanvasState) (bool, error) { left, _ := clause["left"].(string) op, _ := clause["op"].(string) if op == "" { op = "==" } // "empty" is the only operator that does not read `right`. if op == "empty" { return isEmptyValue(leftValue(left, state)), nil } right := clause["right"] lv := leftValue(left, state) switch op { case "==": return equalValues(lv, right), nil case "!=": return !equalValues(lv, right), nil case "contains": // Treat the right-hand side as a string needle. ls, rs := fmt.Sprintf("%v", lv), fmt.Sprintf("%v", right) return containsString(ls, rs), nil case ">", "<": ln, lok := numericize(lv) rn, rok := numericize(right) if !lok || !rok { return false, fmt.Errorf("operator %q requires numeric operands (left=%T, right=%T)", op, lv, right) } if op == ">" { return ln > rn, nil } return ln < rn, nil default: return false, fmt.Errorf("unknown operator %q", op) } } // leftValue resolves a {{...}} reference against state. References // without braces are returned as a literal (matches ResolveTemplate's // pre-check behavior). func leftValue(left string, state *runtime.CanvasState) any { if left == "" { return "" } // If the caller supplied an un-resolved literal (no {{...}}), pass // it through unchanged so operators like "==" can compare against // the raw value (e.g. left="raw string" → returned as "raw string"). if !runtime.VarRefPattern.MatchString(left) { return left } resolved, err := runtime.ResolveTemplate(left, state) if err != nil { // On resolution failure, return the raw string so == can still // operate; we don't want a misconfigured ref to crash the run. return left } return resolved } // equalValues compares two any values with a forgiving type coercion // (string ↔ fmt-rendered, int ↔ float64). Returns false on type // mismatches that don't coerce cleanly. func equalValues(a, b any) bool { if a == nil || b == nil { return a == nil && b == nil } // Stringify then compare — covers most canvas-DSL comparisons. return fmt.Sprintf("%v", a) == fmt.Sprintf("%v", b) } func containsString(haystack, needle string) bool { if needle == "" { return true } return indexOf(haystack, needle) >= 0 } // indexOf is a tiny wrapper around strings.Index to keep the operator // table readable. strings import is hidden behind this helper to // minimize the import list surface. func indexOf(s, sub string) int { // use stdlib to avoid hand-rolling for i := 0; i+len(sub) <= len(s); i++ { if s[i:i+len(sub)] == sub { return i } } return -1 } // numericize attempts to convert v to float64. Returns ok=false if v // is a string that doesn't parse as a number (e.g. an LLM response); // numeric operators will then error out with a clear message. func numericize(v any) (float64, bool) { switch x := v.(type) { case int: return float64(x), true case int64: return float64(x), true case float64: return x, true case float32: return float64(x), true case string: f, err := strconv.ParseFloat(x, 64) if err != nil { return 0, false } return f, true default: return 0, false } } // isEmptyValue reports whether a value is "empty" by the canvas DSL // definition: nil, empty string, empty slice, empty map. func isEmptyValue(v any) bool { switch x := v.(type) { case nil: return true case string: return x == "" case []any: return len(x) == 0 case map[string]any: return len(x) == 0 } return false } // mapsCopyDup is a no-op duplicate alias kept for symmetry with the // begin.go / message.go helpers in the package; here Switch doesn't // need to copy maps but the alias documents the convention. var _ = mapsCopyDup func mapsCopyDup(dst, src map[string]any) { maps.Copy(dst, src) } func init() { Register(componentNameSwitch, NewSwitchComponent) }