package v1 import ( "net/http" "github.com/gin-gonic/gin" "github.com/gochat/gochat/internal/model" "github.com/gochat/gochat/internal/service" applogger "github.com/gochat/gochat/pkg/logger" "github.com/gochat/gochat/pkg/response" ) // CaptainScenarioHandler handles CaptainScenario REST API endpoints. // Reference: Chatwoot enterprise/app/controllers/api/v1/captain/scenarios_controller.rb type CaptainScenarioHandler struct { svc *service.CaptainScenarioService } // NewCaptainScenarioHandler creates a new CaptainScenarioHandler. func NewCaptainScenarioHandler(svc *service.CaptainScenarioService) *CaptainScenarioHandler { return &CaptainScenarioHandler{svc: svc} } // Create creates a new scenario under an assistant. // POST /api/v1/accounts/:account_id/captain_assistants/:assistant_id/scenarios func (h *CaptainScenarioHandler) Create(c *gin.Context) { accountID := parseAccountIDParam(c) if accountID == 0 { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid account_id") return } assistantID, err := parseUintParam(c, "assistant_id") if err != nil { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid assistant_id") return } var req service.CreateScenarioRequest if err := bindNestedJSONPayload(c, "scenario", &req); err != nil { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrValidation, err.Error()) return } scenario, err := h.svc.Create(c.Request.Context(), accountID, assistantID, &req) if err != nil { applogger.L().Errorf("Create captain scenario: %v", err) response.AbortWithStatusError(c, captainAssistantErrorStatus(err), response.ErrInternal, "failed to create scenario") return } c.JSON(http.StatusOK, captainScenarioPayload(scenario)) } // Get retrieves a scenario by ID. // GET /api/v1/accounts/:account_id/captain_assistants/:assistant_id/scenarios/:id func (h *CaptainScenarioHandler) Get(c *gin.Context) { accountID := parseAccountIDParam(c) if accountID == 0 { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid account_id") return } assistantID, err := parseUintParam(c, "assistant_id") if err != nil { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid assistant_id") return } id, err := parseUintAnyParam(c, "scenario_id", "id") if err != nil { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid id") return } scenario, err := h.svc.Get(c.Request.Context(), accountID, assistantID, id) if err != nil { applogger.L().Errorf("Get captain scenario: %v", err) response.AbortWithStatusError(c, http.StatusNotFound, response.ErrNotFound, "scenario not found") return } c.JSON(http.StatusOK, captainScenarioPayload(scenario)) } // Update updates an existing scenario. // PUT /api/v1/accounts/:account_id/captain_assistants/:assistant_id/scenarios/:id func (h *CaptainScenarioHandler) Update(c *gin.Context) { accountID := parseAccountIDParam(c) if accountID == 0 { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid account_id") return } assistantID, err := parseUintParam(c, "assistant_id") if err != nil { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid assistant_id") return } id, err := parseUintAnyParam(c, "scenario_id", "id") if err != nil { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid id") return } var req service.UpdateScenarioRequest if err := bindNestedJSONPayload(c, "scenario", &req); err != nil { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrValidation, err.Error()) return } scenario, err := h.svc.UpdateScoped(c.Request.Context(), accountID, assistantID, id, &req) if err != nil { applogger.L().Errorf("Update captain scenario: %v", err) response.AbortWithStatusError(c, captainAssistantErrorStatus(err), response.ErrInternal, "failed to update scenario") return } c.JSON(http.StatusOK, captainScenarioPayload(scenario)) } // Delete deletes a scenario. // DELETE /api/v1/accounts/:account_id/captain_assistants/:assistant_id/scenarios/:id func (h *CaptainScenarioHandler) Delete(c *gin.Context) { accountID := parseAccountIDParam(c) if accountID == 0 { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid account_id") return } assistantID, err := parseUintParam(c, "assistant_id") if err != nil { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid assistant_id") return } id, err := parseUintAnyParam(c, "scenario_id", "id") if err != nil { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid id") return } if err := h.svc.DeleteScoped(c.Request.Context(), accountID, assistantID, id); err != nil { applogger.L().Errorf("Delete captain scenario: %v", err) response.AbortWithStatusError(c, captainAssistantErrorStatus(err), response.ErrInternal, "failed to delete scenario") return } response.NoContent(c) } // List retrieves scenarios for an assistant. // GET /api/v1/accounts/:account_id/captain_assistants/:assistant_id/scenarios func (h *CaptainScenarioHandler) List(c *gin.Context) { accountID := parseAccountIDParam(c) if accountID == 0 { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid account_id") return } assistantID, err := parseUintParam(c, "assistant_id") if err != nil { response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid assistant_id") return } scenarios, count, err := h.svc.ListByAccountAssistant(c.Request.Context(), accountID, assistantID) if err != nil { applogger.L().Errorf("List captain scenarios: %v", err) response.AbortWithStatusError(c, captainAssistantErrorStatus(err), response.ErrInternal, "failed to list scenarios") return } payload := make([]gin.H, 0, len(scenarios)) for i := range scenarios { payload = append(payload, captainScenarioPayload(&scenarios[i])) } c.JSON(http.StatusOK, gin.H{"payload": payload, "meta": gin.H{"total_count": count, "page": 1}}) } func captainScenarioPayload(scenario *model.CaptainScenario) gin.H { payload := gin.H{ "id": scenario.ID, "title": scenario.Title, "description": scenario.Description, "instruction": scenario.Instruction, "tools": rawJSONValue(scenario.Tools), "enabled": scenario.Enabled, "assistant_id": scenario.AssistantID, "account_id": scenario.AccountID, "created_at": scenario.CreatedAt, "updated_at": scenario.UpdatedAt, } if scenario.Assistant.ID != 0 { payload["assistant"] = gin.H{"id": scenario.Assistant.ID, "name": scenario.Assistant.Name} } return payload }