artifact

type Artifact struct {
	// ID 唯一标识
	ID string `json:"id"`

	// SessionID 关联的会话 ID
	SessionID string `json:"session_id"`

	// Name 文件名称（同名同 session 的多个 artifact 视为不同版本）
	Name string `json:"name"`

	// MimeType MIME 类型
	MimeType string `json:"mime_type"`

	// Data 文件内容
	Data []byte `json:"data,omitempty"`

	// Version 版本号（从 1 开始自增）
	Version int `json:"version"`

	// Size 文件大小（字节）
	Size int64 `json:"size"`

	// Metadata 额外元数据
	Metadata map[string]any `json:"metadata,omitempty"`

	// CreatedAt 创建时间
	CreatedAt time.Time `json:"created_at"`

	// CreatedBy 创建者（Agent ID）
	CreatedBy string `json:"created_by,omitempty"`
}

type MemoryStore struct {
	// contains filtered or unexported fields
}

type Option func(*Service)

type Service struct {
	// contains filtered or unexported fields
}

type Store interface {
	// Save 保存 artifact，返回 ID
	Save(ctx context.Context, art Artifact) (string, error)

	// Get 按 ID 获取 artifact
	Get(ctx context.Context, id string) (*Artifact, error)

	// GetByVersion 按名称和版本获取
	GetByVersion(ctx context.Context, sessionID, name string, version int) (*Artifact, error)

	// GetLatest 获取最新版本
	GetLatest(ctx context.Context, sessionID, name string) (*Artifact, error)

	// List 列出会话下所有 artifact（最新版本）
	List(ctx context.Context, sessionID string) ([]Artifact, error)

	// ListVersions 列出指定名称的所有版本
	ListVersions(ctx context.Context, sessionID, name string) ([]Artifact, error)

	// Delete 删除指定 artifact
	Delete(ctx context.Context, id string) error

	// DeleteAll 删除会话下所有 artifact
	DeleteAll(ctx context.Context, sessionID string) error
}