Files
ragflow/internal/router/admin_routes.go

55 lines
2.1 KiB
Go
Raw Normal View History

feat(agent): Go port — canvas engine, 22 components, DSL v2, 13 endpoints (#15952) Ports the agent canvas subsystem from Python to Go. ## What's included ### Canvas Engine (Phase 0/1) - State engine, scheduler, variable resolver, Redis checkpoint store, cancel protocol - **209 tests** across canvas / component / io packages ### 22 Components (P0–P4) | Tier | Components | |---|---| | P0 T1+T2+T3 | LLM, Agent, ExitLoop, Switch, Categorize, Begin, Message, Invoke | | P1 T3 | VariableAggregator, VariableAssigner, StringTransform, ListOperations, DataOperations | | P2 T3 | Iteration, IterationItem, Loop, LoopItem | | P3 T3 | UserFillUp, Fillup | | P4 T5 | Browser, ExcelProcessor, DocsGenerator | ### DSL v2 Schema (Phase 2.5) - Typed v2 in-memory model with v1-to-v2 auto-detect converter - v1 legacy field stripping per plan §2.11.7 ### HTTP Endpoints & Bug Fixes (Plans PR1–PR3) - **DELETE SQL bug fix**: gorm v2 `Where("id = ?", id).Delete(...)` pattern - **CreateAgent validation**: title/DSL required, duplicate check, 103 envelope - **13 new endpoints**: templates, prompts, tags, sessions CRUD, chat/completions (SSE + non-stream stubs), rerun, test_db_connection, logs, webhook/logs - **756 Go unit tests** (745 → 756, +18) - **17 → 0 Python integration test failures** (test_agents.py + test_session_management/) ### Tools 21 eino tools: HTTPHelper, search tools, financial/data tools, mandatory stubs ### Infrastructure OTel observability, NATS message queue, DeepDoc gRPC client, SSRF guards, IDOR mitigation
2026-06-12 22:58:28 +08:00
//
// 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 router — admin_routes.go registers the Phase 6 per-tenant
// canvas-runtime override endpoint on the existing v1 admin group. It is
// kept separate from router.go so future admin endpoints can land here
// without churn in the main route table.
package router
import (
"github.com/gin-gonic/gin"
"ragflow/internal/handler"
)
// RegisterAdminRuntimeRoutes wires the canvas-runtime override endpoint
// onto an existing /admin RouterGroup. The caller is expected to be the
// authorised v1 group; this function is intentionally agnostic of the
// full path prefix so the same registration helper works for the main
// server and any future admin sub-app.
//
// The single route is:
//
// POST /api/v1/admin/canvas-runtime/:tenant_id
// body: {"runtime": "go" | "python" | "auto"}
// response: 200 {"code":0,"tenant_id":...,"runtime":...,"message":"ok"}
//
// The handler h must be non-nil. A handler with a nil selector (e.g.
// the server started before Redis was reachable) still serves this
// route — SetTenantRuntime responds with HTTP 500 and
// ErrSelectorNotConfigured. The previous version of this function
// silently no-op'd on a nil handler, which made the route disappear
// after a Redis outage at boot and only re-appear on the next process
// restart. Review follow-up: keep the route hot, surface a clear error
// to the operator.
func RegisterAdminRuntimeRoutes(g *gin.RouterGroup, h *handler.AdminRuntimeHandler) {
if g == nil || h == nil {
return
}
g.POST("/canvas-runtime/:tenant_id", h.SetTenantRuntime)
}