-
Notifications
You must be signed in to change notification settings - Fork 0
feat: personality preset discovery API (list/get endpoints) #755
Copy link
Copy link
Closed
Labels
prio:mediumShould do, but not blockingShould do, but not blockingscope:medium1-3 days of work1-3 days of workspec:agent-systemDESIGN_SPEC Section 3 - Agent SystemDESIGN_SPEC Section 3 - Agent Systemspec:apitype:featureNew feature implementationNew feature implementationv0.5Minor version v0.5Minor version v0.5v0.5.5Patch release v0.5.5Patch release v0.5.5
Description
Summary
Expose personality presets via REST API so clients can discover available presets without hardcoding names.
Motivation
Currently, preset names must be known in advance -- there's no API to list or inspect available presets. The setup wizard silently falls back to pragmatic_builder for unknown presets. Clients (dashboard, CLI, third-party integrations) need a way to discover what's available.
Proposed Endpoints
GET /api/v1/personalities/presets-- list all available presets (name, description, traits summary)GET /api/v1/personalities/presets/{name}-- get full preset definition (all fields)GET /api/v1/personalities/schema-- return the PersonalityConfig JSON schema (for client-side validation)
Current State
PERSONALITY_PRESETSis a frozenMappingProxyTypeinsrc/synthorg/templates/presets.pyget_personality_preset(name)exists but is internal-only (not exposed via API)- Templates already support both
personality_preset(by name) andpersonality(inline dict) PersonalityConfigmodel insrc/synthorg/core/agent.pyvalidates all personality data
Notes
- Read-only endpoints for builtin presets; CRUD for user-defined presets is tracked separately
- Should include pagination for future-proofing as custom presets are added
- Response should distinguish builtin vs user-defined presets (via a
sourcefield)
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
prio:mediumShould do, but not blockingShould do, but not blockingscope:medium1-3 days of work1-3 days of workspec:agent-systemDESIGN_SPEC Section 3 - Agent SystemDESIGN_SPEC Section 3 - Agent Systemspec:apitype:featureNew feature implementationNew feature implementationv0.5Minor version v0.5Minor version v0.5v0.5.5Patch release v0.5.5Patch release v0.5.5