ttstd-infinite-canvas/backend/internal/app/cloud_agent_anchor.go

package app

import (
	"strings"

	"infinite-canvas/backend/internal/model"
	"infinite-canvas/backend/internal/repository"
)

// The anchor records the current request and observable reference candidates.
// It does not infer creative permissions or carry an old goal into a new turn.
type cloudAgentCreativeAnchor struct {
	Version          int                         `json:"version"`
	UserPrompt       string                      `json:"userPrompt"`
	ReferenceNodeIDs []string                    `json:"referenceNodeIds,omitempty"`
	ReferenceAssets  []cloudAgentReferenceAnchor `json:"referenceAssets,omitempty"`
}

type cloudAgentReferenceAnchor struct {
	NodeID                   string   `json:"nodeId"`
	Type                     string   `json:"type"`
	Title                    string   `json:"title,omitempty"`
	Prompt                   string   `json:"prompt,omitempty"`
	AssetTags                []string `json:"assetTags,omitempty"`
	ReferenceReady           bool     `json:"referenceReady"`
	VisualIdentity           string   `json:"visualIdentity"`
	RequiresVisualInspection bool     `json:"requiresVisualInspection"`
	// VisualNote 是模型看过这张图之后自己写下的一句观察。锚点会跨轮继承，
	// 因此下一轮不必重复看图也能拿到文字观察（推理内容不会回灌上下文）。
	VisualNote string `json:"visualNote,omitempty"`
	Width      any    `json:"width,omitempty"`
	Height     any    `json:"height,omitempty"`
}

// cloudAgentCreativeAnchorForCanvas 按当前画布重建候选素材锚点。
// inherited 是上一轮的锚点：只继承"视觉事实"——已经看过的画面和模型自己写下的观察；
// 用户目标、权限和旧计划都不继承（用户消息才是本轮目标，候选素材按当前画布重建，
// 避免把过期素材带进新轮）。
func cloudAgentCreativeAnchorForCanvas(repo *repository.Repository, userID string, canvas *model.CanvasProject, prompt string, inherited *cloudAgentCreativeAnchor) (cloudAgentCreativeAnchor, error) {
	anchor := cloudAgentCreativeAnchor{Version: 2, UserPrompt: prompt}
	inspected := map[string]cloudAgentReferenceAnchor{}
	if inherited != nil {
		for _, asset := range inherited.ReferenceAssets {
			if asset.VisualIdentity == "inspected" {
				inspected[asset.NodeID] = asset
			}
		}
	}

	doc, err := creationDocument(canvas.PayloadJSON)
	if err != nil {
		return cloudAgentCreativeAnchor{}, BadAuthRequest("服务端画布内容无法解析，请先重新同步")
	}
	nodes := creationMaps(doc["nodes"])
	byID := make(map[string]map[string]any, len(nodes))
	for _, node := range nodes {
		if id := stringValue(node["id"]); id != "" {
			byID[id] = node
		}
	}

	ids := make([]string, 0, 16)
	for _, node := range nodes {
		descriptor, known := cloudAgentNodeCapabilityForType(stringValue(node["type"]))
		if known && descriptor.Connection.CanReference {
			ids = append(ids, stringValue(node["id"]))
		}
		if len(ids) == 16 {
			break
		}
	}
	for _, id := range ids {
		if id == "" || byID[id] == nil {
			continue
		}
		node := byID[id]
		descriptor, known := cloudAgentNodeCapabilityForType(stringValue(node["type"]))
		if !known || !descriptor.Connection.CanReference {
			continue
		}
		meta, _ := node["metadata"].(map[string]any)
		item := cloudAgentReferenceAnchor{
			NodeID: stringValue(node["id"]), Type: stringValue(node["type"]),
			Title:          truncateRunes(stringValue(node["title"]), 300),
			Prompt:         truncateRunes(firstNonEmpty(stringValue(meta["prompt"]), stringValue(meta["composerContent"])), 1000),
			VisualIdentity: "unknown", RequiresVisualInspection: true,
		}
		if tags, ok := meta["assetTags"].([]any); ok {
			for _, tag := range tags {
				if text := strings.TrimSpace(stringValue(tag)); text != "" {
					item.AssetTags = append(item.AssetTags, truncateRunes(text, 120))
				}
			}
		}
		if repo != nil {
			ref, _, refErr := cloudAgentReference(repo, userID, node)
			if refErr == nil {
				item.ReferenceReady = true
				item.Width, item.Height = ref["width"], ref["height"]
			}
		}
		if viewed, ok := inspected[item.NodeID]; ok {
			// 这一轮之前已经看过画面：直接继承模型自己写下的观察，不重复看图。
			item.VisualIdentity = "inspected"
			item.RequiresVisualInspection = false
			item.VisualNote = viewed.VisualNote
		}
		anchor.ReferenceNodeIDs = append(anchor.ReferenceNodeIDs, item.NodeID)
		anchor.ReferenceAssets = append(anchor.ReferenceAssets, item)
		if len(anchor.ReferenceAssets) == 16 {
			break
		}
	}
	return anchor, nil
}