Definitions of Locator Types and Extensions

[mtrinell]

Hello,

I'm wondering what's the source of truth (i.e., code definition) for Locator Types and Extensions in OASF: https://schema.oasf.agntcy.org/objects/locator?extensions= / https://schema.oasf.agntcy.org/features?extensions=

If I look at Locators, in OASF I see this json (https://github.com/agntcy/oasf/blob/main/schema/objects/locator.json), that does not really match the types in the online schema above (see python_package vs py-package).

Also, if I look at the .proto file defined in agntcy/dir (https://github.com/agntcy/dir/blob/main/api/proto/core/v1alpha2/locator.proto#L17), I see that:

1. the type for type is a string, and not an enum (which is later defined as enum LocatorType). I guess this doesn't help to have validation out of the box (from auto-generated files)
2. Looking at the inline comments, the enum list here once again doesn't seem to match the ones in OASF (see python-package).

Can someone clarify/help? Thanks in advance!

[ramizpolic]

Hi @mtrinell, currently there is a slight difference between the locator types in OASF and Directory and we are aware of this. Starting from the v0.4.0 OASF release planned for this week, these two values should be identical and all the OASF-related objects in Directory will be imported directly from OASF. From there, the validation and other ops should work out-of-box.

[mtrinell]

Thanks @ramizpolic . What about extension names? Are these well defined / enumerated?

[ramizpolic]

The extensions are valid and use named IDs which represent the extension's name. These remain unchanged.

[mtrinell]

@ramizpolic do you mind to please send a reference of the code where such extension names are defined? I can't find definitions for those across the oasf/dir repos.

Just to be clear, with extension names I mean this one (as an example): schema.oasf.agntcy.org/features/runtime/manifest

Thanks

[ramizpolic]

The list of all the currently supported extensions can be found here: https://schema.oasf.agntcy.org/features
Each extension name is defined as part of a given feature, ie. extension_name = schema.oasf.agntcy.org/features/<feature>.
If you open a specific feature like https://schema.oasf.agntcy.org/features/observability, you can find the extension name there. Hope this helps.