package api import ( "fmt" "net/url" "strconv" "strings" "time" "github.com/gin-gonic/gin" "github.com/google/uuid" "github.com/yaoapp/gou/connector" "github.com/yaoapp/yao/agent/assistant" chatctx "github.com/yaoapp/yao/agent/context" "github.com/yaoapp/yao/agent/message" store "github.com/yaoapp/yao/agent/store/types" "github.com/yaoapp/yao/agent/types" "github.com/yaoapp/yao/helper" "github.com/yaoapp/yao/openapi/oauth" ) // API registers the Agent API endpoints func (agent *API) API(router *gin.Engine, path string) error { // Get the guards middlewares, err := agent.getGuardHandlers() if err != nil { return err } // Chat endpoint // Chat endpoint // Example: // curl -X GET 'http://localhost:5099/api/__yao/agent?content=Hello&chat_id=chat_123&context=previous_context&token=xxx' // curl -X POST 'http://localhost:5099/api/__yao/agent' \ // -H 'Content-Type: application/json' \ // -d '{"content": "Hello", "chat_id": "chat_123", "context": "previous_context", "token": "xxx"}' router.GET(path, append(middlewares, agent.handleChat)...) router.POST(path, append(middlewares, agent.handleChat)...) // Status check endpoint // Example: // curl -X GET 'http://localhost:5099/api/__yao/agent/status?token=xxx' router.GET(path+"/status", append(middlewares, agent.handleStatus)...) // Assistant API endpoints // List assistants example: // curl -X GET 'http://localhost:5099/api/__yao/agent/assistants?page=1&pagesize=20&tags=tag1,tag2&token=xxx' router.GET(path+"/assistants", append(middlewares, agent.HandleAssistantList)...) // Get all assistant tags example: // curl -X GET 'http://localhost:5099/api/__yao/agent/assistants/tags?token=xxx' router.GET(path+"/assistants/tags", append(middlewares, agent.HandleAssistantTags)...) // Get assistant details example: // curl -X GET 'http://localhost:5099/api/__yao/agent/assistants/assistant_123?token=xxx' router.GET(path+"/assistants/:id", append(middlewares, agent.HandleAssistantDetail)...) // Execute assistant API example: // curl -X POST 'http://localhost:5099/api/__yao/agent/assistants/assistant_123/api' \ // -H 'Content-Type: application/json' \ // -d '{"name": "Test", "payload": {"name": "yao", "age": 18}}' router.POST(path+"/assistants/:id/call", append(middlewares, agent.HandleAssistantCall)...) // Create/Update assistant example: // curl -X POST 'http://localhost:5099/api/__yao/agent/assistants' \ // -H 'Content-Type: application/json' \ // -d '{"name": "My Assistant", "type": "chat", "tags": ["tag1", "tag2"], "mentionable": true, "avatar": "path/to/avatar.png", "token": "xxx"}' router.POST(path+"/assistants", append(middlewares, agent.HandleAssistantSave)...) // Delete assistant example: // curl -X DELETE 'http://localhost:5099/api/__yao/agent/assistants/assistant_123?token=xxx' router.DELETE(path+"/assistants/:id", append(middlewares, agent.HandleAssistantDelete)...) // Chat management endpoints // List chats example: // curl -X GET 'http://localhost:5099/api/__yao/agent/chats?page=1&pagesize=20&keywords=search+term&order=desc&token=xxx' router.GET(path+"/chats", append(middlewares, agent.handleChatList)...) // Get latest chat example: // curl -X GET 'http://localhost:5099/api/__yao/agent/chats/latest?assistant_id=assistant_123&token=xxx' router.GET(path+"/chats/latest", append(middlewares, agent.handleChatLatest)...) // Get chat details example: // curl -X GET 'http://localhost:5099/api/__yao/agent/chats/chat_123?token=xxx' router.GET(path+"/chats/:id", append(middlewares, agent.handleChatDetail)...) // Update chat example: // curl -X POST 'http://localhost:5099/api/__yao/agent/chats/chat_123' \ // -H 'Content-Type: application/json' \ // -d '{"title": "New Title", "content": "Chat content for title generation", "token": "xxx"}' router.POST(path+"/chats/:id", append(middlewares, agent.handleChatUpdate)...) // Delete chat example: // curl -X DELETE 'http://localhost:5099/api/__yao/agent/chats/chat_123?token=xxx' router.DELETE(path+"/chats/:id", append(middlewares, agent.handleChatDelete)...) // Chat history endpoint // Example: // curl -X GET 'http://localhost:5099/api/__yao/agent/history?chat_id=chat_123&token=xxx' router.GET(path+"/history", append(middlewares, agent.handleChatHistory)...) // File management endpoints // Upload file example: // curl -X POST 'http://localhost:5099/api/__yao/agent/upload?chat_id=chat_123&token=xxx' \ // -F 'file=@/path/to/file.txt' // router.POST(path+"/upload/:storage", append(middlewares, agent.handleUpload)...) // Download file example: // curl -X GET 'http://localhost:5099/api/__yao/agent/download?file_id=file_123&disposition=attachment&token=xxx' \ // -o downloaded_file.txt // router.GET(path+"/download", append(middlewares, agent.handleDownload)...) // Mentions endpoint // Example: // curl -X GET 'http://localhost:5099/api/__yao/agent/mentions?keywords=assistant&token=xxx' router.GET(path+"/mentions", append(middlewares, agent.handleMentions)...) // Generate title example: // curl -X GET 'http://localhost:5099/api/__yao/agent/generate/title?content=Chat+content&chat_id=chat_123&token=xxx' // curl -X POST 'http://localhost:5099/api/__yao/agent/generate/title' \ // -H 'Content-Type: application/json' \ // -d '{"content": "Chat content", "chat_id": "chat_123", "token": "xxx"}' router.GET(path+"/generate/title", append(middlewares, agent.handleGenerateTitle)...) router.POST(path+"/generate/title", append(middlewares, agent.handleGenerateTitle)...) // Generate prompts example: // curl -X GET 'http://localhost:5099/api/__yao/agent/generate/prompts?content=Generate+prompts&chat_id=chat_123&token=xxx' // curl -X POST 'http://localhost:5099/api/__yao/agent/generate/prompts' \ // -H 'Content-Type: application/json' \ // -d '{"content": "Generate prompts", "chat_id": "chat_123", "token": "xxx"}' router.GET(path+"/generate/prompts", append(middlewares, agent.handleGeneratePrompts)...) router.POST(path+"/generate/prompts", append(middlewares, agent.handleGeneratePrompts)...) // Utility endpoints // List connectors example: // curl -X GET 'http://localhost:5099/api/__yao/agent/utility/connectors?token=xxx' router.GET(path+"/utility/connectors", append(middlewares, agent.handleConnectors)...) // Dangerous operations // Dangerous operations // Clear all chats example: // curl -X DELETE 'http://localhost:5099/api/__yao/agent/dangerous/clear_chats?token=xxx' router.DELETE(path+"/dangerous/clear_chats", append(middlewares, agent.handleChatsDeleteAll)...) return nil } // handleStatus handles the status request func (agent *API) handleStatus(c *gin.Context) { c.Status(200) c.Done() } // handleChat handles the chat request func (agent *API) handleChat(c *gin.Context) { // Set headers for SSE c.Header("Content-Type", "text/event-stream;charset=utf-8") c.Header("Cache-Control", "no-cache") c.Header("Connection", "keep-alive") sid := c.GetString("__sid") if sid == "" { sid = uuid.New().String() } content := c.Query("content") if content == "" { msg := message.New().Error("content is required").Done() msg.Write(c.Writer) return } chatID := c.Query("chat_id") if chatID == "" { // Only generate new chat_id if not provided chatID = fmt.Sprintf("chat_%d", time.Now().UnixNano()) } // Set the context with validated chat_id ctx, cancel := chatctx.NewWithCancel(c.Request.Context(), nil, chatID, c.Query("context")) defer cancel() defer ctx.Release() // Release the context after the request is done // // Set the assistant ID // assistantID := c.Query("assistant_id") // if assistantID != "" { // ctx = chatctx.WithAssistantID(ctx, assistantID) // } // // Set the silent mode // silent := c.Query("silent") // if silent == "true" || silent == "1" { // ctx = chatctx.WithSilent(ctx, true) // } // // Set the history visible // historyVisible := c.Query("history_visible") // if historyVisible != "" { // ctx = chatctx.WithHistoryVisible(ctx, historyVisible == "true" || historyVisible == "1") // } // // Set the client type // clientType := c.Query("client_type") // if clientType != "" { // ctx = chatctx.WithClientType(ctx, clientType) // } err := agent.Answer(ctx, content, c) // Error handling if err != nil { message.New().Done().Error(err).Write(c.Writer) c.Done() return } } // handleChatList handles the chat list request func (agent *API) handleChatList(c *gin.Context) { sid := c.GetString("__sid") if sid == "" { c.JSON(400, gin.H{"message": "sid is required", "code": 400}) c.Done() return } // Create filter from query parameters filter := store.ChatFilter{ Keywords: c.Query("keywords"), Order: c.Query("order"), } // Parse page and pagesize if page := c.Query("page"); page != "" { if n, err := strconv.Atoi(page); err == nil { filter.Page = n } } if pageSize := c.Query("pagesize"); pageSize != "" { if n, err := strconv.Atoi(pageSize); err == nil { filter.PageSize = n } } locale := "en-us" if loc := c.Query("locale"); loc != "" { locale = strings.ToLower(strings.TrimSpace(loc)) } response, err := agent.Store.GetChats(sid, filter, locale) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } c.JSON(200, map[string]interface{}{"data": response}) c.Done() } // handleChatHistory handles the chat history request func (agent *API) handleChatHistory(c *gin.Context) { sid := c.GetString("__sid") if sid == "" { c.JSON(400, gin.H{"message": "sid is required", "code": 400}) c.Done() return } cid := c.Query("chat_id") history, err := agent.Store.GetHistory(sid, cid) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } c.JSON(200, map[string]interface{}{"data": history}) c.Done() } // getOrigin returns the request origin func (agent *API) getOrigin(c *gin.Context) string { origin := c.Request.Header.Get("Origin") if origin == "" { origin = c.Request.Referer() if origin != "" { if u, err := url.Parse(origin); err == nil { origin = fmt.Sprintf("%s://%s", u.Scheme, u.Host) } } } return origin } // getGuardHandlers returns authentication middleware handlers func (agent *API) getGuardHandlers() ([]gin.HandlerFunc, error) { return []gin.HandlerFunc{}, nil } // defaultGuard is the default authentication handler func (agent *API) defaultGuard(c *gin.Context) { // Check if the request is for OpenAPI OAuth if oauth.OAuth != nil { agent.guardOpenapiOauth(c) return } token := strings.TrimSpace(strings.TrimPrefix(c.Query("token"), "Bearer ")) if token == "" { c.JSON(403, gin.H{"message": "token is required", "code": 403}) c.Abort() return } user := helper.JwtValidate(token) c.Set("__sid", user.SID) c.Next() } // Openapi Oauth func (agent *API) guardOpenapiOauth(c *gin.Context) { s := oauth.OAuth token := agent.getAccessToken(c) if token == "" { c.JSON(403, gin.H{"code": 403, "message": "Not Authorized"}) c.Abort() return } // Validate the token _, err := s.VerifyToken(token) if err != nil { c.JSON(403, gin.H{"code": 403, "message": "Not Authorized"}) c.Abort() return } // Get the session ID sid := agent.getSessionID(c) if sid == "" { c.JSON(403, gin.H{"code": 403, "message": "Not Authorized"}) c.Abort() return } c.Set("__sid", sid) } func (agent *API) getAccessToken(c *gin.Context) string { token := c.GetHeader("Authorization") if token == "" || token == "Bearer undefined" { cookie, err := c.Cookie("__Host-access_token") if err != nil { return "" } token = cookie } return strings.TrimPrefix(token, "Bearer ") } func (agent *API) getSessionID(c *gin.Context) string { sid, err := c.Cookie("__Host-session_id") if err != nil { return "" } return sid } // handleChatLatest handles getting the latest chat func (agent *API) handleChatLatest(c *gin.Context) { sid := c.GetString("__sid") if sid == "" { c.JSON(400, gin.H{"message": "sid is required", "code": 400}) c.Done() return } locale := "en-us" if loc := c.Query("locale"); loc != "" { locale = strings.ToLower(strings.TrimSpace(loc)) } // Get the chats chats, err := agent.Store.GetChats(sid, store.ChatFilter{Page: 1}, locale) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } // Create a new chat if len(chats.Groups) == 0 || len(chats.Groups[0].Chats) == 0 { assistantID := agent.Use.Default queryAssistantID := c.Query("assistant_id") if queryAssistantID != "" { assistantID = queryAssistantID } // Get the assistant info ast, err := assistant.Get(assistantID) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } c.JSON(200, map[string]interface{}{"data": map[string]interface{}{ "placeholder": ast.GetPlaceholder(locale), "assistant_id": ast.ID, "assistant_name": ast.GetName(locale), "assistant_avatar": ast.Avatar, "assistant_deleteable": agent.Use.Default != ast.ID, }}) c.Done() return } // Get the chat_id chatID, ok := chats.Groups[0].Chats[0]["chat_id"].(string) if !ok { c.JSON(404, gin.H{"message": "chat_id not found", "code": 404}) c.Done() return } chat, err := agent.Store.GetChat(sid, chatID, locale) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } // assistant_id is nil return the default assistant if chat.Chat["assistant_id"] == nil { chat.Chat["assistant_id"] = agent.Use.Default // Get the assistant info ast, err := assistant.Get(agent.Use.Default) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } chat.Chat["assistant_name"] = ast.GetName(locale) chat.Chat["assistant_avatar"] = ast.Avatar } chat.Chat["assistant_deleteable"] = agent.Use.Default != chat.Chat["assistant_id"] c.JSON(200, map[string]interface{}{"data": chat}) c.Done() } // handleChatDetail handles getting a single chat's details func (agent *API) handleChatDetail(c *gin.Context) { sid := c.GetString("__sid") if sid == "" { c.JSON(400, gin.H{"message": "sid is required", "code": 400}) c.Done() return } chatID := c.Param("id") if chatID == "" { c.JSON(400, gin.H{"message": "chat id is required", "code": 400}) c.Done() return } locale := "en-us" if loc := c.Query("locale"); loc != "" { locale = strings.ToLower(strings.TrimSpace(loc)) } // Get the chat details chat, err := agent.Store.GetChat(sid, chatID, locale) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } // assistant_id is nil return the default assistant if chat.Chat["assistant_id"] == nil { chat.Chat["assistant_id"] = agent.Use.Default // Get the assistant info ast, err := assistant.Get(agent.Use.Default) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } chat.Chat["assistant_name"] = ast.GetName(locale) chat.Chat["assistant_avatar"] = ast.Avatar } chat.Chat["assistant_deleteable"] = agent.Use.Default != chat.Chat["assistant_id"] c.JSON(200, map[string]interface{}{"data": chat}) c.Done() } // handleMentions handles getting mentions for a chat func (agent *API) handleMentions(c *gin.Context) { sid := c.GetString("__sid") if sid == "" { c.JSON(400, gin.H{"message": "sid is required", "code": 400}) c.Done() return } locale := "en-us" if loc := c.Query("locale"); loc != "" { locale = strings.ToLower(strings.TrimSpace(loc)) } // Get keywords from query parameter keywords := strings.ToLower(c.Query("keywords")) mentionable := true // Query mentionable assistants filter := store.AssistantFilter{ Keywords: keywords, Mentionable: &mentionable, Page: 1, PageSize: 20, } response, err := agent.Store.GetAssistants(filter, locale) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } // Convert assistants to mentions mentions := []types.Mention{} for _, assistant := range response.Data { mention := types.Mention{ ID: assistant.ID, Name: assistant.Name, Type: assistant.Type, Avatar: assistant.Avatar, } mentions = append(mentions, mention) } c.JSON(200, map[string]interface{}{"data": mentions}) c.Done() } // handleChatUpdate handles updating a chat's details func (agent *API) handleChatUpdate(c *gin.Context) { sid := c.GetString("__sid") if sid == "" { c.JSON(400, gin.H{"message": "sid is required", "code": 400}) c.Done() return } chatID := c.Param("id") if chatID == "" { c.JSON(400, gin.H{"message": "chat id is required", "code": 400}) c.Done() return } // Get title from request body var body struct { Title string `json:"title"` Content string `json:"content"` } if err := c.BindJSON(&body); err != nil { c.JSON(400, gin.H{"message": "invalid request body", "code": 400}) c.Done() return } if body.Title == "" { c.JSON(400, gin.H{"message": "title is required", "code": 400}) c.Done() return } err := agent.Store.UpdateChatTitle(sid, chatID, body.Title) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } c.JSON(200, gin.H{"message": "ok", "title": body.Title, "chat_id": chatID}) c.Done() } // handleChatDelete handles deleting a single chat func (agent *API) handleChatDelete(c *gin.Context) { sid := c.GetString("__sid") if sid == "" { c.JSON(400, gin.H{"message": "sid is required", "code": 400}) c.Done() return } chatID := c.Param("id") if chatID == "" { c.JSON(400, gin.H{"message": "chat id is required", "code": 400}) c.Done() return } err := agent.Store.DeleteChat(sid, chatID) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } c.JSON(200, gin.H{"message": "ok"}) c.Done() } // handleChatsDeleteAll handles deleting all chats for a user func (agent *API) handleChatsDeleteAll(c *gin.Context) { sid := c.GetString("__sid") if sid == "" { c.JSON(400, gin.H{"message": "sid is required", "code": 400}) c.Done() return } err := agent.Store.DeleteAllChats(sid) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } c.JSON(200, gin.H{"message": "ok"}) c.Done() } // handleGenerateTitle handles generating a chat title func (agent *API) handleGenerateTitle(c *gin.Context) { // Set headers for SSE c.Header("Content-Type", "text/event-stream;charset=utf-8") c.Header("Cache-Control", "no-cache") c.Header("Connection", "keep-alive") sid := c.GetString("__sid") if sid == "" { sid = uuid.New().String() } content := c.Query("content") if content == "" { msg := message.New().Error("content is required").Done() msg.Write(c.Writer) return } chatID := fmt.Sprintf("generate_title_%d", time.Now().UnixNano()) // Set the context with validated chat_id ctx, cancel := chatctx.NewWithCancel(c.Request.Context(), nil, chatID, c.Query("context")) defer cancel() defer ctx.Release() // Release the context after the request is done // // Set the assistant ID // ctx = chatctx.WithHistoryVisible(ctx, false) // ctx = chatctx.WithAssistantID(ctx, agent.Use.Title) err := agent.Answer(ctx, content, c) // Error handling if err != nil { message.New().Done().Error(err).Write(c.Writer) c.Done() return } } // handleGeneratePrompts handles generating prompts func (agent *API) handleGeneratePrompts(c *gin.Context) { // Set headers for SSE c.Header("Content-Type", "text/event-stream;charset=utf-8") c.Header("Cache-Control", "no-cache") c.Header("Connection", "keep-alive") sid := c.GetString("__sid") if sid == "" { sid = uuid.New().String() } content := c.Query("content") if content == "" { msg := message.New().Error("content is required").Done() msg.Write(c.Writer) return } chatID := fmt.Sprintf("generate_prompts_%d", time.Now().UnixNano()) // Set the context with validated chat_id ctx, cancel := chatctx.NewWithCancel(c.Request.Context(), nil, chatID, c.Query("context")) defer cancel() defer ctx.Release() // Release the context after the request is done // // Set the assistant ID // ctx = chatctx.WithHistoryVisible(ctx, false) // ctx = chatctx.WithAssistantID(ctx, agent.Use.Prompt) err := agent.Answer(ctx, content, c) // Error handling if err != nil { message.New().Done().Error(err).Write(c.Writer) c.Done() return } } // HandleAssistantList handles listing assistants (exported for use in openapi/agent) func (agent *API) HandleAssistantList(c *gin.Context) { // Parse filter parameters filter := store.AssistantFilter{ Type: "assistant", Page: 1, PageSize: 20, } // Parse page and pagesize if page := c.Query("page"); page != "" { if n, err := strconv.Atoi(page); err == nil { filter.Page = n } } if pageSize := c.Query("pagesize"); pageSize != "" { if n, err := strconv.Atoi(pageSize); err == nil { filter.PageSize = n } } // Parse tags if tags := c.Query("tags"); tags != "" { filter.Tags = strings.Split(tags, ",") } // Parse keywords if keywords := c.Query("keywords"); keywords != "" { filter.Keywords = keywords } // Parse connector if connector := c.Query("connector"); connector != "" { filter.Connector = connector } // Parse select fields if selectFields := c.Query("select"); selectFields != "" { filter.Select = strings.Split(selectFields, ",") } // Parse built_in (support various boolean formats) if builtIn := c.Query("built_in"); builtIn != "" { val := parseBoolValue(builtIn) if val != nil { filter.BuiltIn = val } } // Parse mentionable (support various boolean formats) if mentionable := c.Query("mentionable"); mentionable != "" { val := parseBoolValue(mentionable) if val != nil { filter.Mentionable = val } } // Parse automated (support various boolean formats) if automated := c.Query("automated"); automated != "" { val := parseBoolValue(automated) if val != nil { filter.Automated = val } } // Parse assistant_id if assistantID := c.Query("assistant_id"); assistantID != "" { filter.AssistantID = assistantID } locale := "en-us" // Default locale if loc := c.Query("locale"); loc != "" { locale = strings.ToLower(strings.TrimSpace(loc)) } response, err := agent.Store.GetAssistants(filter, locale) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } c.JSON(200, response) c.Done() } // parseBoolValue parses various string formats into a boolean pointer // Supports: 1, 0, "1", "0", "true", "false", etc. func parseBoolValue(value string) *bool { value = strings.ToLower(strings.TrimSpace(value)) switch value { case "1", "true", "yes", "on": v := true return &v case "0", "false", "no", "off": v := false return &v default: return nil } } // HandleAssistantCall handles the assistant API call (exported for use in openapi/agent) func (agent *API) HandleAssistantCall(c *gin.Context) { assistantID := c.Param("id") if assistantID == "" { c.JSON(400, gin.H{"message": "assistant id is required", "code": 400}) c.Done() return } ast, err := assistant.Get(assistantID) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } sid := c.GetString("__sid") if sid == "" { c.JSON(400, gin.H{"message": "sid is required", "code": 400}) c.Done() return } payload := assistant.APIPayload{Sid: sid} if err := c.BindJSON(&payload); err != nil { c.JSON(400, gin.H{"message": "invalid request body", "code": 400}) c.Done() return } result, err := ast.Call(c, payload) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } c.JSON(200, result) c.Done() } // HandleAssistantDetail handles getting a single assistant's details (exported for use in openapi/agent) func (agent *API) HandleAssistantDetail(c *gin.Context) { assistantID := c.Param("id") if assistantID == "" { c.JSON(400, gin.H{"message": "assistant id is required", "code": 400}) c.Done() return } filter := store.AssistantFilter{ AssistantID: assistantID, Type: "assistant", Page: 1, PageSize: 1, } locale := "en-us" // Default locale // Translate the response if loc := c.Query("locale"); loc != "" { locale = strings.ToLower(strings.TrimSpace(loc)) } response, err := agent.Store.GetAssistants(filter, locale) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } if len(response.Data) == 0 { c.JSON(404, gin.H{"message": "assistant not found", "code": 404}) c.Done() return } c.JSON(200, gin.H{"data": response.Data[0]}) c.Done() } // HandleAssistantSave handles creating or updating an assistant (exported for use in openapi/agent) func (agent *API) HandleAssistantSave(c *gin.Context) { var assistantData map[string]interface{} if err := c.BindJSON(&assistantData); err != nil { c.JSON(400, gin.H{"message": "invalid request body", "code": 400}) c.Done() return } // Convert to AssistantModel model, err := store.ToAssistantModel(assistantData) if err != nil { c.JSON(400, gin.H{"message": fmt.Sprintf("invalid assistant data: %s", err.Error()), "code": 400}) c.Done() return } id, err := agent.Store.SaveAssistant(model) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } // Update the assistant map with the returned ID if it's not already set if _, ok := assistantData["assistant_id"]; !ok { assistantData["assistant_id"] = id } // Remove the assistant from cache to ensure fresh data on next load cache := assistant.GetCache() if cache != nil { cache.Remove(id) } // Reload the assistant to ensure it's available in cache with updated data _, err = assistant.Get(id) if err != nil { // Just log the error, don't fail the request fmt.Printf("Error reloading assistant %s: %v\n", id, err) } c.JSON(200, gin.H{"message": "ok", "data": assistantData}) c.Done() } // HandleAssistantDelete handles deleting an assistant (exported for use in openapi/agent) func (agent *API) HandleAssistantDelete(c *gin.Context) { assistantID := c.Param("id") if assistantID == "" { c.JSON(400, gin.H{"message": "assistant id is required", "code": 400}) c.Done() return } err := agent.Store.DeleteAssistant(assistantID) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } // Remove the assistant from cache to ensure it's fully deleted cache := assistant.GetCache() if cache != nil { cache.Remove(assistantID) } c.JSON(200, gin.H{"message": "ok"}) c.Done() } // handleConnectors handles listing connectors func (agent *API) handleConnectors(c *gin.Context) { options := []map[string]interface{}{} // Filter and format connectors for id, conn := range connector.Connectors { if conn.Is(connector.OPENAI) || conn.Is(connector.MOAPI) { setting := conn.Setting() label := setting["label"] if label == nil || label == "" { label = setting["name"] } if label == nil || label == "" { label = id } options = append(options, map[string]interface{}{ "label": label, "value": id, }) } } c.JSON(200, gin.H{"data": options}) c.Done() } // HandleAssistantTags handles getting all assistant tags (exported for use in openapi/agent) func (agent *API) HandleAssistantTags(c *gin.Context) { locale := "en-us" // Default locale if loc := c.Query("locale"); loc != "" { locale = strings.ToLower(strings.TrimSpace(loc)) } // Build filter for tags query filter := store.AssistantFilter{} // Apply type filter (default to "assistant") typeParam := strings.TrimSpace(c.Query("type")) if typeParam == "" { typeParam = "assistant" } filter.Type = typeParam // Apply other optional filters if connector := strings.TrimSpace(c.Query("connector")); connector != "" { filter.Connector = connector } if builtInParam := c.Query("built_in"); builtInParam != "" { if val, err := strconv.ParseBool(builtInParam); err == nil { filter.BuiltIn = &val } } if mentionableParam := c.Query("mentionable"); mentionableParam != "" { if val, err := strconv.ParseBool(mentionableParam); err == nil { filter.Mentionable = &val } } if automatedParam := c.Query("automated"); automatedParam != "" { if val, err := strconv.ParseBool(automatedParam); err == nil { filter.Automated = &val } } if keywords := strings.TrimSpace(c.Query("keywords")); keywords != "" { filter.Keywords = keywords } tags, err := agent.Store.GetAssistantTags(filter, locale) if err != nil { c.JSON(500, gin.H{"message": err.Error(), "code": 500}) c.Done() return } c.JSON(200, gin.H{"data": tags}) c.Done() }