catalog

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

type Description struct {
	// Name is the enabled capability's exact dotted name.
	Name string `json:"name"`

	// Signature is generated from the same compiled plan used for binding.
	Signature string `json:"signature"`

	// Summary is the compact searchable description.
	Summary string `json:"summary"`

	// Description is the full registered description.
	Description string `json:"description"`

	// Input is the ordered supported input field shape.
	Input []binding.FieldShape `json:"input"`

	// Output is the ordered supported output field shape.
	Output []binding.FieldShape `json:"output"`
}

type Entry struct {
	// ID is the stable deployment and policy identity.
	ID string

	// Name is the dotted Starlark and model-facing capability name.
	Name string

	// Summary is the compact search description.
	Summary string

	// Description is the full exact-description text.
	Description string

	// Plan is the immutable input, output, canonical-argument, and signature plan.
	Plan *binding.Plan

	// Invoke calls the registered typed handler through its registration-time adapter.
	Invoke Invoker
	// contains filtered or unexported fields
}

type Invoker func(context.Context, authz.Subject, any) (any, error)

type NamespaceBinding struct {
	// Segments contains the namespace path before the final function name.
	Segments []string

	// Function is the final Starlark function segment.
	Function string

	// Capability is the enabled catalog entry represented by this function.
	Capability Entry
}

type Options struct {
	// DisabledCapabilities lists stable IDs removed from every live catalog surface.
	DisabledCapabilities []string

	// MaxSearchQueryBytes bounds search input before normalization.
	MaxSearchQueryBytes int

	// MaxSearchResults bounds the deterministic result list.
	MaxSearchResults int
}

type Registration struct {
	// ID is the stable deployment and policy identity.
	ID string

	// Name is the dotted Starlark and model-facing capability name.
	// The first segment must not collide with a reserved Starlark universe root.
	Name string

	// Summary is the compact description used by capability search.
	Summary string

	// Description is the full exact-description text.
	Description string

	// SearchTerms contains alternative task vocabulary used only for discovery.
	SearchTerms []string

	// Plan is the caller-compiled input, output, canonical-argument, and signature plan.
	Plan *binding.Plan

	// Invoke calls the registered typed handler through its registration-time adapter.
	Invoke Invoker
}

type SearchResponse struct {
	// Results contains the packed ranked prefix of eligible capabilities.
	Results []SearchResult `json:"results"`

	// Truncated reports whether at least one eligible result was omitted.
	Truncated bool `json:"truncated"`
}

type SearchResult struct {
	// Name is the enabled capability's exact dotted name.
	Name string `json:"name"`

	// Signature is generated from the same compiled plan used for binding.
	Signature string `json:"signature"`

	// Summary is the compact searchable description.
	Summary string `json:"summary"`
}