spec_ingester

type GraphBuilder struct {
	FalconDir string
}

type IngestParams struct {
	Action string `json:"action"` // "index", "update", "status"
	Source string `json:"source"` // file path or URL
}

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

type OpenAPIParser struct{}

type ParsedEndpoint struct {
	Method      string
	Path        string
	Summary     string
	Description string
	Parameters  []ParsedParameter
	// Simplified representation of request/response for initial indexing
	HasBody   bool
	Responses []int
}

type ParsedParameter struct {
	Name     string
	In       string // query, path, header, etc.
	Required bool
	Type     string
}

type ParsedSpec struct {
	Format    string // "openapi3", "swagger2", "postman2.1"
	Version   string
	Endpoints []ParsedEndpoint
}

type PostmanParser struct{}

type SpecParser interface {
	// DetectFormat returns true if the parser can handle the given content
	DetectFormat(content []byte) bool

	// Parse converts the raw content into a unified APIKnowledgeGraph structure
	// It basically extracts endpoints and models but returns them in a generic map first
	// to be later processed by the GraphBuilder
	Parse(content []byte) (*ParsedSpec, error)
}