surfaces

package
v0.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 26, 2026 License: MIT Imports: 4 Imported by: 0

Documentation

Overview

Package surfaces defines the static extension resource surface policy.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func NormalizeAllowedKinds

func NormalizeAllowedKinds(kinds []resources.ResourceKind) ([]resources.ResourceKind, error)

NormalizeAllowedKinds validates and normalizes operator-config allowlisted kinds.

func PublishableKinds

func PublishableKinds() []resources.ResourceKind

PublishableKinds returns the kinds that extensions may publish.

Types

type GrantRequest

type GrantRequest struct {
	Kinds    []resources.ResourceKind
	Scopes   []resources.ResourceScopeKind
	MaxScope resources.ResourceScopeKind
}

GrantRequest is the validated manifest request shape resolved from family names.

func ResolveManifestRequest

func ResolveManifestRequest(
	families []string,
	maxScope resources.ResourceScopeKind,
) (GrantRequest, error)

ResolveManifestRequest validates one family-oriented manifest request against the surface table.

type ManifestFamily

type ManifestFamily string

ManifestFamily identifies one family-oriented manifest request name.

const (
	FamilyHooks              ManifestFamily = "hooks"
	FamilyTools              ManifestFamily = "tools"
	FamilyAgents             ManifestFamily = "agents"
	FamilyMCPServers         ManifestFamily = "mcp_servers"
	FamilySkills             ManifestFamily = "skills"
	FamilyAutomationJobs     ManifestFamily = "automation_jobs"
	FamilyAutomationTriggers ManifestFamily = "automation_triggers"
	FamilyBundles            ManifestFamily = "bundles"
	FamilyBridgeInstances    ManifestFamily = "bridge_instances"
	FamilyBundleActivations  ManifestFamily = "bundle_activations"
)

type Surface

type Surface struct {
	Kind             resources.ResourceKind
	ManifestFamily   ManifestFamily
	ExtensionPublish bool
	LegalScopes      []resources.ResourceScopeKind
}

Surface declares the daemon-authoritative resource publication metadata for one kind.

func All

func All() []Surface

All returns the full static surface registry.

func Lookup

func Lookup(kind resources.ResourceKind) (Surface, bool)

Lookup resolves one resource kind from the static registry.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL