chore: commit workspace updates

backend/internal/app/cloud_agent_mutation.go

@@ -0,0 +1,59 @@
+package app
+
+import (
+	"time"
+
+	"infinite-canvas/backend/internal/model"
+	"infinite-canvas/backend/internal/repository"
+)
+
+const cloudAgentMutationSnapshotLimit = 1 << 20
+
+type cloudAgentMutationInput struct {
+	RunID              string
+	UserID             string
+	CanvasID           string
+	StepID             string
+	Operation          string
+	BeforeSnapshotHash string
+	AfterSnapshotHash  string
+	BeforeJSON         string
+	HasSubmittedTask   bool
+}
+
+func cloudAgentMutationRecorderForRun(runID string) cloudAgentMutationRecorder {
+	return func(repo *repository.Repository, input cloudAgentMutationInput) error {
+		input.RunID = runID
+		return recordCloudAgentCanvasMutation(repo, input)
+	}
+}
+
+type cloudAgentMutationRecorder func(*repository.Repository, cloudAgentMutationInput) error
+
+func recordCloudAgentCanvasMutation(repo *repository.Repository, input cloudAgentMutationInput) error {
+	if input.RunID == "" || input.UserID == "" || input.CanvasID == "" || input.StepID == "" || input.Operation == "" {
+		return BadAuthRequest("画布变更缺少可追踪的 Agent 操作信息")
+	}
+	if input.BeforeSnapshotHash == "" || input.AfterSnapshotHash == "" {
+		return BadAuthRequest("画布变更缺少有效快照")
+	}
+	mutation := &model.CloudAgentCanvasMutation{
+		ID:                 newID(),
+		RunID:              input.RunID,
+		UserID:             input.UserID,
+		CanvasID:           input.CanvasID,
+		StepID:             input.StepID,
+		Operation:          input.Operation,
+		BeforeSnapshotHash: input.BeforeSnapshotHash,
+		AfterSnapshotHash:  input.AfterSnapshotHash,
+		HasSubmittedTask:   input.HasSubmittedTask,
+		Status:             "applied",
+		CreatedAt:          time.Now().UTC(),
+	}
+	if len(input.BeforeJSON) <= cloudAgentMutationSnapshotLimit {
+		mutation.BeforeJSON = input.BeforeJSON
+	} else {
+		mutation.Status = "not_undoable"
+	}
+	return repo.CreateCloudAgentCanvasMutation(mutation)
+}