tools

type Backend interface {
	WorkspaceID() models.WorkspaceID

	SoulsList(ctx context.Context) ([]models.Soul, error)
	SoulsGet(ctx context.Context, slug models.Slug) (*models.Soul, error)
	SoulsUpsert(ctx context.Context, slug models.Slug, content string) (*models.Soul, error)
	SoulsDelete(ctx context.Context, slug models.Slug) error

	PersonasList(ctx context.Context) ([]models.Persona, error)
	PersonasGet(ctx context.Context, slug models.Slug) (*models.Persona, error)
	PersonasUpsert(ctx context.Context, slug models.Slug, content string, bundledRules []models.Slug) (*models.Persona, error)
	PersonasDelete(ctx context.Context, slug models.Slug) error

	RulesList(ctx context.Context) ([]models.Rule, error)
	RulesGet(ctx context.Context, slug models.Slug) (*models.Rule, error)
	RulesUpsert(ctx context.Context, slug models.Slug, entries []models.RuleEntry) (*models.Rule, error)
	RulesDelete(ctx context.Context, slug models.Slug) error

	BrainsList(ctx context.Context) ([]models.Brain, error)
	BrainsGet(ctx context.Context, slug models.Slug) (*models.Brain, error)
	BrainsUpsert(ctx context.Context, slug, soulSlug, personaSlug models.Slug, ruleSlugs []models.Slug, prefs *models.ModelPrefs) (*models.Brain, error)
	BrainsDelete(ctx context.Context, slug models.Slug) error

	StateFindLayers(ctx context.Context, projectSlug, sessionID string) ([]models.LayerOverride, error)
	StateResolveForScope(ctx context.Context, projectSlug, sessionID string) (*models.EffectiveState, error)
	StateSet(ctx context.Context, scopeType models.ScopeType, referenceID string, partial *models.LayerOverride) error
	StateDelete(ctx context.Context, scopeType models.ScopeType, referenceID string) error

	ComposePrompt(ctx context.Context, req models.ComposeRequest) (*models.ComposeResponse, error)

	VersionsList(ctx context.Context, contentType models.ContentType, slug models.Slug) ([]models.VersionSummary, error)
	VersionsGet(ctx context.Context, contentType models.ContentType, slug models.Slug, version int) (*models.ContentVersion, error)

	WorkspaceCreate(ctx context.Context, name string) (*models.Workspace, error)
	WorkspaceList(ctx context.Context) ([]models.Workspace, error)
	WorkspaceGetByName(ctx context.Context, name string) (*models.Workspace, error)
	WorkspaceRename(ctx context.Context, id models.WorkspaceID, newName string) (*models.Workspace, error)
	WorkspaceDelete(ctx context.Context, id models.WorkspaceID) error
	WorkspacePurge(ctx context.Context, id models.WorkspaceID) error

	APIKeyCreate(ctx context.Context, label string) (plaintext string, record *models.APIKey, err error)
	APIKeyList(ctx context.Context) ([]models.APIKeySummary, error)
	APIKeyRevoke(ctx context.Context, id models.APIKeyID) error

	AdminExport(ctx context.Context) (*bundle.ContentBundle, error)
	AdminImport(ctx context.Context, cb *bundle.ContentBundle) (*bundle.ImportResult, error)
}