schemaruntime

type BuiltSchemaCache struct {
	Meta               []byte
	ProductShards      []byte
	PayloadShards      []byte
	Descriptors        []ProductDescriptor
	PayloadDescriptors []CommandPayloadDescriptor
	RegistrySHA256     [sha256.Size]byte
	RegistryDataSize   uint64
	PayloadSHA256      [sha256.Size]byte
	PayloadDataSize    uint64
	// The payload file opens with the length-prefixed SchemaPayloadIndex
	// region; these pins let the binary authenticate that region without
	// reading Meta first. Payload descriptor offsets are relative to the first
	// byte after the index region.
	PayloadIndexLength uint64
	PayloadIndexSHA256 [sha256.Size]byte
}

type CacheHashes struct {
	SourceSHA256  [sha256.Size]byte
	SurfaceSHA256 [sha256.Size]byte
}

type CommandIdentity struct {
	CLIPath   string
	Canonical string
	Aliases   []string
	ProductID string
	Title     string
}

type CommandMeta struct {
	Identity  CommandIdentity
	Safety    CommandSafety
	Selection CommandSelection
}

type CommandPayloadDescriptor struct {
	ProductID    string
	Offset       uint64
	Length       uint64
	SHA256       [sha256.Size]byte
	HeaderLength uint64
	HeaderSHA256 [sha256.Size]byte
}

type CommandSafety struct {
	Effect       string
	Risk         string
	Confirmation string
	Idempotency  string
}

type CommandSelection struct {
	AgentSummary  string
	UseWhen       []string
	AvoidWhen     []string
	Prerequisites []string
	Tips          []string
	Examples      []string
}

type DecodedCommandPayloads struct {
	ProductID string
	// Commands maps each lookup path (primary and alias) to the complete
	// CommandMeta: identity, Safety, and Selection.
	Commands map[string]CommandMeta
	// LeafIndex locates each canonical path's pre-rendered compact leaf bytes
	// inside the shard's blob region, sorted by canonical path.
	LeafIndex []RenderedLeafRef
	// RenderedLeaves carries the verified leaf bytes only for the whole-shard
	// decode used by round-trip verification; header reads leave it nil.
	RenderedLeaves map[string][]byte
}

type DecodedSchemaMeta struct {
	Kind                 string
	Level                string
	Source               string
	AgentMetadata        json.RawMessage
	CommandMetaByPath    map[string]CommandMeta
	Overview             SchemaOverview
	LocatorProductByPath map[string]string
	ProductDescriptors   []ProductDescriptor
	PayloadDescriptors   []CommandPayloadDescriptor
	RegistryDataLength   uint64
	PayloadDataLength    uint64
	PayloadSHA256        [sha256.Size]byte
	RegistryDataSHA256   [sha256.Size]byte
	Hashes               CacheHashes
	// contains filtered or unexported fields
}

type DecodedSchemaPayloadIndex struct {
	LocatorProductByPath map[string]string
	PayloadDescriptors   []CommandPayloadDescriptor
}

type DecodedSchemaProduct struct {
	Registry SchemaRegistry
	Index    SchemaIndex
}

type OverviewProduct struct {
	ID          string
	ToolCount   uint64
	SchemaPath  string
	SummaryKind OverviewSummaryKind
	Summary     string
}

type OverviewSummaryKind string

type ParameterSpec struct {
	Name                 string
	Type                 string
	Description          string
	Property             string
	Required             bool
	CLIRequired          bool
	RequiredWhen         string
	Default              json.RawMessage
	InterfaceDefault     json.RawMessage
	Example              json.RawMessage
	AnyOf                []contract.FormatAlternative
	Format               string
	Enum                 []string
	InterfaceDescription string
	InterfaceType        string
	FieldProvenance      map[string]contract.FieldProvenance
}

type ProductDescriptor struct {
	ProductID string
	Offset    uint64
	Length    uint64
	SHA256    [sha256.Size]byte
}

type ProductSpec struct {
	ID              string
	Name            string
	Description     string
	Runtime         bool
	Tools           []ToolSpec
	Selection       contract.SelectionSpec
	FieldProvenance map[string]contract.FieldProvenance
}

type QueryProjectors struct {
	ProductSummary func(ProductSpec) (map[string]any, error)
	ToolSummary    func(ToolSpec) (map[string]any, error)
}

type RenderedLeafRef struct {
	CanonicalPath string
	Offset        uint64
	Length        uint64
	SHA256        [sha256.Size]byte
}

type RuntimeToolSpecInput struct {
	Identity        contract.ToolIdentitySpec
	Display         string
	Title           string
	Description     string
	MetadataSource  string
	Parameters      []ParameterSpec
	Constraints     contract.RuntimeSchemaConstraints
	Positionals     []contract.RuntimeSchemaPositional
	DryRun          *contract.DryRunSpec
	Wait            *contract.WaitSpec
	Result          *contract.ResultSpec
	Pagination      *contract.PaginationSpec
	Safety          contract.SafetySpec
	Interface       contract.InterfaceSpec
	Selection       contract.SelectionSpec
	FieldProvenance map[string]contract.FieldProvenance
}

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

type SchemaOverview struct {
	Kind          string
	Level         string
	Source        string
	AgentMetadata json.RawMessage
	Products      []OverviewProduct
	ToolCount     uint64
}

type SchemaRegistry struct {
	Kind          string
	Level         string
	Source        string
	Products      []ProductSpec
	AgentMetadata json.RawMessage
}

type SchemaSnapshotPayload struct {
	Catalog map[string]any
	Tools   map[string]map[string]any
}

type SnapshotProjectors struct {
	ToolSummary    func(ToolSpec) (map[string]any, error)
	ToolPayload    func(ToolSpec) (map[string]any, error)
	ProductSummary func(ProductSpec) (map[string]any, error)
}

type ToolSpec struct {
	Identity        contract.ToolIdentitySpec
	Display         string
	Title           string
	Description     string
	MetadataSource  string
	Parameters      []ParameterSpec
	Constraints     contract.RuntimeSchemaConstraints
	Positionals     []contract.RuntimeSchemaPositional
	DryRun          *contract.DryRunSpec
	Wait            *contract.WaitSpec
	Result          *contract.ResultSpec
	Pagination      *contract.PaginationSpec
	Safety          contract.SafetySpec
	Interface       contract.InterfaceSpec
	Selection       contract.SelectionSpec
	FieldProvenance map[string]contract.FieldProvenance
}

type TrustedHashes struct {
	CatalogHash string
	SurfaceHash string
}

type UnknownPathError struct{ Path string }