Documentation
¶
Index ¶
- func InitAssistantPresetStoreHandlers(api huma.API, store *AssistantPresetStore)
- func SetPreparedData(s *AssistantPresetStore, fileName string, dirName string, data map[string]any) error
- func ValidateAssistantPresetStructure(preset *spec.AssistantPreset) error
- type AssistantPresetStore
- func (s *AssistantPresetStore) Close() error
- func (s *AssistantPresetStore) DeleteAssistantPreset(ctx context.Context, req *spec.DeleteAssistantPresetRequest) (*spec.DeleteAssistantPresetResponse, error)
- func (s *AssistantPresetStore) DeleteAssistantPresetBundle(ctx context.Context, req *spec.DeleteAssistantPresetBundleRequest) (*spec.DeleteAssistantPresetBundleResponse, error)
- func (s *AssistantPresetStore) GetAssistantPreset(ctx context.Context, req *spec.GetAssistantPresetRequest) (*spec.GetAssistantPresetResponse, error)
- func (s *AssistantPresetStore) ListAssistantPresetBundles(ctx context.Context, req *spec.ListAssistantPresetBundlesRequest) (*spec.ListAssistantPresetBundlesResponse, error)
- func (s *AssistantPresetStore) ListAssistantPresets(ctx context.Context, req *spec.ListAssistantPresetsRequest) (*spec.ListAssistantPresetsResponse, error)
- func (s *AssistantPresetStore) PatchAssistantPreset(ctx context.Context, req *spec.PatchAssistantPresetRequest) (*spec.PatchAssistantPresetResponse, error)
- func (s *AssistantPresetStore) PatchAssistantPresetBundle(ctx context.Context, req *spec.PatchAssistantPresetBundleRequest) (*spec.PatchAssistantPresetBundleResponse, error)
- func (s *AssistantPresetStore) PutAssistantPreset(ctx context.Context, req *spec.PutAssistantPresetRequest) (*spec.PutAssistantPresetResponse, error)
- func (s *AssistantPresetStore) PutAssistantPresetBundle(ctx context.Context, req *spec.PutAssistantPresetBundleRequest) (*spec.PutAssistantPresetBundleResponse, error)
- type BuiltInData
- func (d *BuiltInData) Close() error
- func (d *BuiltInData) GetBuiltInAssistantPreset(ctx context.Context, bundleID bundleitemutils.BundleID, ...) (spec.AssistantPreset, error)
- func (d *BuiltInData) GetBuiltInBundle(ctx context.Context, id bundleitemutils.BundleID) (spec.AssistantPresetBundle, error)
- func (d *BuiltInData) ListBuiltInData(ctx context.Context) (bundles map[bundleitemutils.BundleID]spec.AssistantPresetBundle, ...)
- func (d *BuiltInData) SetAssistantPresetBundleEnabled(ctx context.Context, id bundleitemutils.BundleID, enabled bool) (spec.AssistantPresetBundle, error)
- func (d *BuiltInData) SetAssistantPresetEnabled(ctx context.Context, bundleID bundleitemutils.BundleID, ...) (spec.AssistantPreset, error)
- type BuiltInDataOption
- type MCPContextLookup
- type ModelPresetLookup
- type ModelPresetSummary
- type Option
- func WithBuiltInDataOptions(opts ...BuiltInDataOption) Option
- func WithMCPContextLookup(lookup MCPContextLookup) Option
- func WithModelPresetLookup(lookup ModelPresetLookup) Option
- func WithReferenceLookups(lookups ReferenceLookups) Option
- func WithSkillLookup(lookup SkillLookup) Option
- func WithToolSelectionLookup(lookup ToolSelectionLookup) Option
- type ReferenceLookups
- type SkillLookup
- type SkillSummary
- type ToolSelectionLookup
- type ToolSummary
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func InitAssistantPresetStoreHandlers ¶
func InitAssistantPresetStoreHandlers(api huma.API, store *AssistantPresetStore)
func SetPreparedData ¶
func SetPreparedData( s *AssistantPresetStore, fileName string, dirName string, data map[string]any, ) error
SetPreparedData is only for tests/runtime preparation helpers.
func ValidateAssistantPresetStructure ¶ added in v0.2.9
func ValidateAssistantPresetStructure(preset *spec.AssistantPreset) error
ValidateAssistantPresetStructure exposes the owning store's structural validation for read-only projections. It intentionally does not resolve installed-resource references.
Types ¶
type AssistantPresetStore ¶
type AssistantPresetStore struct {
// contains filtered or unexported fields
}
func NewAssistantPresetStore ¶
func NewAssistantPresetStore(baseDir string, opts ...Option) (*AssistantPresetStore, error)
func (*AssistantPresetStore) Close ¶
func (s *AssistantPresetStore) Close() error
func (*AssistantPresetStore) DeleteAssistantPreset ¶
func (s *AssistantPresetStore) DeleteAssistantPreset( ctx context.Context, req *spec.DeleteAssistantPresetRequest, ) (*spec.DeleteAssistantPresetResponse, error)
func (*AssistantPresetStore) DeleteAssistantPresetBundle ¶
func (s *AssistantPresetStore) DeleteAssistantPresetBundle( ctx context.Context, req *spec.DeleteAssistantPresetBundleRequest, ) (*spec.DeleteAssistantPresetBundleResponse, error)
func (*AssistantPresetStore) GetAssistantPreset ¶
func (s *AssistantPresetStore) GetAssistantPreset( ctx context.Context, req *spec.GetAssistantPresetRequest, ) (*spec.GetAssistantPresetResponse, error)
func (*AssistantPresetStore) ListAssistantPresetBundles ¶
func (s *AssistantPresetStore) ListAssistantPresetBundles( ctx context.Context, req *spec.ListAssistantPresetBundlesRequest, ) (*spec.ListAssistantPresetBundlesResponse, error)
func (*AssistantPresetStore) ListAssistantPresets ¶
func (s *AssistantPresetStore) ListAssistantPresets( ctx context.Context, req *spec.ListAssistantPresetsRequest, ) (*spec.ListAssistantPresetsResponse, error)
func (*AssistantPresetStore) PatchAssistantPreset ¶
func (s *AssistantPresetStore) PatchAssistantPreset( ctx context.Context, req *spec.PatchAssistantPresetRequest, ) (*spec.PatchAssistantPresetResponse, error)
func (*AssistantPresetStore) PatchAssistantPresetBundle ¶
func (s *AssistantPresetStore) PatchAssistantPresetBundle( ctx context.Context, req *spec.PatchAssistantPresetBundleRequest, ) (*spec.PatchAssistantPresetBundleResponse, error)
func (*AssistantPresetStore) PutAssistantPreset ¶
func (s *AssistantPresetStore) PutAssistantPreset( ctx context.Context, req *spec.PutAssistantPresetRequest, ) (*spec.PutAssistantPresetResponse, error)
PutAssistantPreset creates a new immutable assistant preset version.
func (*AssistantPresetStore) PutAssistantPresetBundle ¶
func (s *AssistantPresetStore) PutAssistantPresetBundle( ctx context.Context, req *spec.PutAssistantPresetBundleRequest, ) (*spec.PutAssistantPresetBundleResponse, error)
PutAssistantPresetBundle creates or replaces a bundle. Bundle slug is intentionally immutable once the bundle exists so directory addressing for existing version files cannot be orphaned.
type BuiltInData ¶
type BuiltInData struct {
// contains filtered or unexported fields
}
func NewBuiltInData ¶
func NewBuiltInData( ctx context.Context, overlayBaseDir string, snapshotMaxAge time.Duration, lookups ReferenceLookups, opts ...BuiltInDataOption, ) (data *BuiltInData, err error)
func (*BuiltInData) Close ¶
func (d *BuiltInData) Close() error
func (*BuiltInData) GetBuiltInAssistantPreset ¶
func (d *BuiltInData) GetBuiltInAssistantPreset( ctx context.Context, bundleID bundleitemutils.BundleID, slug bundleitemutils.ItemSlug, version bundleitemutils.ItemVersion, ) (spec.AssistantPreset, error)
func (*BuiltInData) GetBuiltInBundle ¶
func (d *BuiltInData) GetBuiltInBundle( ctx context.Context, id bundleitemutils.BundleID, ) (spec.AssistantPresetBundle, error)
func (*BuiltInData) ListBuiltInData ¶
func (d *BuiltInData) ListBuiltInData( ctx context.Context, ) ( bundles map[bundleitemutils.BundleID]spec.AssistantPresetBundle, presets map[bundleitemutils.BundleID]map[bundleitemutils.ItemID]spec.AssistantPreset, err error, )
ListBuiltInData returns deep-copied snapshots.
func (*BuiltInData) SetAssistantPresetBundleEnabled ¶
func (d *BuiltInData) SetAssistantPresetBundleEnabled( ctx context.Context, id bundleitemutils.BundleID, enabled bool, ) (spec.AssistantPresetBundle, error)
func (*BuiltInData) SetAssistantPresetEnabled ¶
func (d *BuiltInData) SetAssistantPresetEnabled( ctx context.Context, bundleID bundleitemutils.BundleID, slug bundleitemutils.ItemSlug, version bundleitemutils.ItemVersion, enabled bool, ) (spec.AssistantPreset, error)
type BuiltInDataOption ¶
type BuiltInDataOption func(*BuiltInData)
func WithBundlesFS ¶
func WithBundlesFS(fsys fs.FS, rootDir string) BuiltInDataOption
WithBundlesFS overrides the default embedded built-in assistant preset FS.
type MCPContextLookup ¶ added in v0.1.22
type MCPContextLookup interface {
ValidateMCPConversationContext(
ctx context.Context,
mcpContext mcpSpec.MCPConversationContext,
) error
}
MCPContextLookup validates MCP starter contexts without coupling this package to a concrete MCP store/runtime implementation.
Implementations should validate persistent server config strictly, but should treat live discovery as best-effort because MCP capabilities are dynamic and may require an active connection/auth session.
type ModelPresetLookup ¶
type ModelPresetLookup interface {
GetModelPresetSummary(
ctx context.Context,
ref modelpresetSpec.ModelPresetRef,
) (ModelPresetSummary, error)
}
ModelPresetLookup validates/loads model preset refs without coupling this package to a concrete model preset store implementation.
type ModelPresetSummary ¶
type ModelPresetSummary struct {
IsEnabled bool
}
type Option ¶
type Option func(*AssistantPresetStore) error
func WithBuiltInDataOptions ¶
func WithBuiltInDataOptions(opts ...BuiltInDataOption) Option
func WithMCPContextLookup ¶ added in v0.1.22
func WithMCPContextLookup(lookup MCPContextLookup) Option
func WithModelPresetLookup ¶
func WithModelPresetLookup(lookup ModelPresetLookup) Option
func WithReferenceLookups ¶
func WithReferenceLookups(lookups ReferenceLookups) Option
func WithSkillLookup ¶
func WithSkillLookup(lookup SkillLookup) Option
func WithToolSelectionLookup ¶
func WithToolSelectionLookup(lookup ToolSelectionLookup) Option
type ReferenceLookups ¶
type ReferenceLookups struct {
ModelPresets ModelPresetLookup
ToolSelections ToolSelectionLookup
Skills SkillLookup
MCPContext MCPContextLookup
}
type SkillLookup ¶
type SkillLookup interface {
GetSkillSummaryForSelection(
ctx context.Context,
selection skillSpec.SkillSelection,
) (SkillSummary, error)
}
SkillLookup validates/loads skill selections without coupling this package to a concrete skill store implementation.
type SkillSummary ¶
type SkillSummary struct {
IsEnabled bool
Insert skillSpec.SkillInsert
// HasArguments is used to reject preloaded instruction skills that need runtime input.
HasArguments bool
HasResources bool
}
type ToolSelectionLookup ¶
type ToolSelectionLookup interface {
GetToolSummaryForSelection(
ctx context.Context,
selection toolSpec.ToolSelection,
) (ToolSummary, error)
}
ToolSelectionLookup validates/loads tool selections without coupling this package to a concrete tool store implementation.
type ToolSummary ¶
type ToolSummary struct {
IsEnabled bool
}