capability

type Capabilities []Capability

type Capability struct {
	comm.BaseModel `bun:"table:api_capability,alias:ac" json:"-"`

	comm.DefaultModel

	CapabilityBasic

	comm.MetaField

} // @name capability

type CapabilityBasic struct {
	// operationId（可为空，公开接口无此字段）
	OperationID string `` /* 142-byte string literal not displayed */
	// API 路径，如 /api/accounts/{id}
	Endpoint string `` /* 135-byte string literal not displayed */
	// HTTP 方法 GET/POST/PUT/DELETE 等
	Method string `` /* 127-byte string literal not displayed */
	// 简短描述
	Summary string `bson:"summary" bun:",notnull,type:text" extensions:"x-order=D" form:"summary" json:"summary" pg:",notnull,type:text"`
	// 详细描述
	Description string `` /* 128-byte string literal not displayed */
	// 参数结构 JSON
	Parameters []SwaggerParam `` /* 145-byte string literal not displayed */
	// 响应结构 map[code]SwaggerResponse
	Responses map[string]SwaggerResponse `` /* 143-byte string literal not displayed */
	// API 标签
	Tags []string `` /* 133-byte string literal not displayed */
	// for meta update
	MetaDiff *comm.MetaDiff `bson:"-" bun:"-" json:"metaUp,omitempty" pg:"-" swaggerignore:"true"`

} // @name capabilityBasic

type CapabilityMatch = aigc.MatchResult

type CapabilitySet struct {
	// operationId（可为空，公开接口无此字段）
	OperationID *string `extensions:"x-order=A" json:"operationID"`
	// API 路径，如 /api/accounts/{id}
	Endpoint *string `extensions:"x-order=B" json:"endpoint"`
	// HTTP 方法 GET/POST/PUT/DELETE 等
	Method *string `extensions:"x-order=C" json:"method"`
	// 简短描述
	Summary *string `extensions:"x-order=D" json:"summary"`
	// 详细描述
	Description *string `extensions:"x-order=E" json:"description"`
	// 参数结构 JSON
	Parameters *[]SwaggerParam `extensions:"x-order=F" json:"parameters,omitempty"`
	// 响应结构 map[code]SwaggerResponse
	Responses *map[string]SwaggerResponse `extensions:"x-order=G" json:"responses,omitempty"`
	// API 标签
	Tags *[]string `extensions:"x-order=H" json:"tags,omitempty"`
	// for meta update
	MetaDiff *comm.MetaDiff `json:"metaUp,omitempty" swaggerignore:"true"`

} // @name capabilitySet

type CapabilityVector struct {
	comm.BaseModel `bun:"table:api_capability_vector,alias:cv" json:"-"`

	comm.DefaultModel

	CapabilityVectorBasic

	comm.MetaField

} // @name capabilityCapabilityVector

type CapabilityVectorBasic struct {
	// 关联的 Capability ID
	CapID oid.OID `bson:"capID" bun:"cap_id,notnull" extensions:"x-order=A" json:"capID" pg:"cap_id,notnull" swaggertype:"string"`
	// 主题 基于 summary + description 等生成
	Subject string `` /* 130-byte string literal not displayed */
	// 语义向量 1024 维
	Vector corpus.Vector `` /* 133-byte string literal not displayed */
	// for meta update
	MetaDiff *comm.MetaDiff `bson:"-" bun:"-" json:"metaUp,omitempty" pg:"-" swaggerignore:"true"`

} // @name capabilityCapabilityVectorBasic

type CapabilityVectorSet struct {
	// 关联的 Capability ID
	CapID *string `extensions:"x-order=A" json:"capID"`
	// 主题 基于 summary + description 等生成
	Subject *string `extensions:"x-order=B" json:"subject"`
	// 语义向量 1024 维
	Vector *corpus.Vector `extensions:"x-order=C" json:"vector"`
	// for meta update
	MetaDiff *comm.MetaDiff `json:"metaUp,omitempty" swaggerignore:"true"`

} // @name capabilityCapabilityVectorSet

type CapabilityVectors []CapabilityVector

type SwaggerParam struct {
	// 参数类型
	Type string `extensions:"x-order=A" form:"type" json:"type" yaml:"type"`
	// 参数描述
	Description string `extensions:"x-order=B" form:"description" json:"description" yaml:"description"`
	// 参数名称
	Name string `extensions:"x-order=C" form:"name" json:"name" yaml:"name"`
	// 参数位置 header/query/body/path
	In string `extensions:"x-order=D" form:"in" json:"in" yaml:"in"`
	// 是否必填
	Required bool `extensions:"x-order=E" form:"required" json:"required,omitempty" yaml:"required"`
	// 参数示例
	Example string `extensions:"x-order=F" form:"example" json:"example,omitempty" yaml:"example"`
	// schema 定义
	Schema any `extensions:"x-order=G" json:"schema,omitempty" yaml:"schema"`

} // @name capabilitySwaggerParam

type SwaggerResponse struct {
	// 响应描述
	Description string `extensions:"x-order=A" form:"description" json:"description" yaml:"description"`
	// schema 定义
	Schema SwaggerSchema `extensions:"x-order=B" json:"schema,omitempty" yaml:"schema"`

} // @name capabilitySwaggerResponse

type SwaggerSchema struct {
	// 引用路径如
	Ref string `extensions:"x-order=A" form:"$ref" json:"$ref,omitempty" yaml:"$ref"`
	// 类型
	Type string `extensions:"x-order=B" form:"type" json:"type,omitempty" yaml:"type"`
	// 描述
	Description string `extensions:"x-order=C" form:"description" json:"description,omitempty" yaml:"description"`
	// allOf 组合
	AllOf []SwaggerSchema `extensions:"x-order=D" json:"allOf,omitempty" yaml:"allOf"`
	// 属性定义
	Properties map[string]SwaggerSchema `extensions:"x-order=E" json:"properties,omitempty" yaml:"properties"`

} // @name capabilitySwaggerSchema