Schema Registry
Package: github.com/emergent-company/emergent.memory/apps/server/pkg/sdk/schemaregistry
Client field: client.SchemaRegistry
The schema registry holds the complete set of object type definitions for a project. Types can originate from schemas (source: "schema"), be created manually (source: "custom"), or be produced by Discovery Jobs (source: "discovered"). The registry drives extraction prompts, UI rendering, and graph validation.
Methods
Section titled “Methods”GetProjectTypes
Section titled “GetProjectTypes”func (c *Client) GetProjectTypes(ctx context.Context, projectID string, opts *ListTypesOptions) ([]SchemaRegistryEntry, error)Returns all object types registered for a project, with optional filters.
GET /api/schema-registry/projects/:projectId
GetObjectType
Section titled “GetObjectType”func (c *Client) GetObjectType(ctx context.Context, projectID, typeName string) (*SchemaRegistryEntry, error)Returns a specific object type definition including its incoming/outgoing relationship types.
GET /api/schema-registry/projects/:projectId/types/:typeName
GetTypeStats
Section titled “GetTypeStats”func (c *Client) GetTypeStats(ctx context.Context, projectID string) (*SchemaRegistryStats, error)Returns counts of types by source and enabled status.
GET /api/schema-registry/projects/:projectId/stats
CreateType
Section titled “CreateType”func (c *Client) CreateType(ctx context.Context, projectID string, req *CreateTypeRequest) (*SchemaRegistryEntry, error)Registers a new custom object type.
POST /api/schema-registry/projects/:projectId/types
UpdateType
Section titled “UpdateType”func (c *Client) UpdateType(ctx context.Context, projectID, typeName string, req *UpdateTypeRequest) (*SchemaRegistryEntry, error)Updates an existing type definition.
PUT /api/schema-registry/projects/:projectId/types/:typeName
DeleteType
Section titled “DeleteType”func (c *Client) DeleteType(ctx context.Context, projectID, typeName string) errorRemoves a type from the project registry. Note: only source: "custom" or source: "discovered" types can be deleted; schema types must be removed by uninstalling the schema.
DELETE /api/schema-registry/projects/:projectId/types/:typeName
HTTP endpoint not yet wrapped in the SDK
Section titled “HTTP endpoint not yet wrapped in the SDK”The server exposes a type version history endpoint that has no SDK method yet:
GET /api/schema-registry/projects/:projectId/types/:typeName/versions
Returns { project_id, type_name, current_version, versions: [...] }, newest first. Each version entry is { registry_id, schema_version, json_schema, ui_config, extraction_config, enabled, description, namespace, created_by, created_at, active }, where active is true on the current version. One persisted snapshot per schema_version is maintained automatically by a DB trigger and backfilled for existing types. Returns 404 if the type does not exist. Uses the same Bearer auth as the other endpoints.
Call it directly with an HTTP client until a GetTypeVersionHistory method is added.
SchemaRegistryEntry
Section titled “SchemaRegistryEntry”type SchemaRegistryEntry struct { ID string `json:"id"` Type string `json:"type"` Source string `json:"source"` // "schema" | "custom" | "discovered" SchemaID *string `json:"schema_id,omitempty"` SchemaName *string `json:"schema_name,omitempty"` SchemaVersion int `json:"schema_version"` JSONSchema json.RawMessage `json:"json_schema"` UIConfig map[string]interface{} `json:"ui_config"` ExtractionConfig map[string]interface{} `json:"extraction_config"` Enabled bool `json:"enabled"` DiscoveryConfidence *float64 `json:"discovery_confidence,omitempty"` Description *string `json:"description,omitempty"` ObjectCount int `json:"object_count,omitempty"` CreatedAt time.Time `json:"created_at"` UpdatedAt time.Time `json:"updated_at"` OutgoingRelationships []RelationshipTypeInfo `json:"outgoing_relationships,omitempty"` IncomingRelationships []RelationshipTypeInfo `json:"incoming_relationships,omitempty"`}RelationshipTypeInfo
Section titled “RelationshipTypeInfo”type RelationshipTypeInfo struct { Type string `json:"type"` Label *string `json:"label,omitempty"` InverseLabel *string `json:"inverse_label,omitempty"` Description *string `json:"description,omitempty"` TargetTypes []string `json:"target_types,omitempty"` SourceTypes []string `json:"source_types,omitempty"`}SchemaRegistryStats
Section titled “SchemaRegistryStats”type SchemaRegistryStats struct { TotalTypes int `json:"total_types"` EnabledTypes int `json:"enabled_types"` SchemaTypes int `json:"schema_types"` CustomTypes int `json:"custom_types"` DiscoveredTypes int `json:"discovered_types"` TotalObjects int `json:"total_objects"` TypesWithObjects int `json:"types_with_objects"`}ListTypesOptions
Section titled “ListTypesOptions”type ListTypesOptions struct { EnabledOnly *bool // Filter enabled types only (server default: true) Source string // "schema" | "custom" | "discovered" | "all" Search string // Search in type names}CreateTypeRequest / UpdateTypeRequest
Section titled “CreateTypeRequest / UpdateTypeRequest”type CreateTypeRequest struct { TypeName string `json:"type_name"` Description *string `json:"description,omitempty"` JSONSchema json.RawMessage `json:"json_schema"` UIConfig json.RawMessage `json:"ui_config,omitempty"` ExtractionConfig json.RawMessage `json:"extraction_config,omitempty"` Enabled *bool `json:"enabled,omitempty"` // defaults true}
type UpdateTypeRequest struct { Description *string `json:"description,omitempty"` JSONSchema json.RawMessage `json:"json_schema,omitempty"` UIConfig json.RawMessage `json:"ui_config,omitempty"` ExtractionConfig json.RawMessage `json:"extraction_config,omitempty"` Enabled *bool `json:"enabled,omitempty"`}Example
Section titled “Example”// List all enabled types for a projectall := truetypes, err := client.SchemaRegistry.GetProjectTypes(ctx, "proj-abc", &schemaregistry.ListTypesOptions{ EnabledOnly: &all,})for _, t := range types { fmt.Printf("%s (%s) — %d objects\n", t.Type, t.Source, t.ObjectCount)}
// Register a custom typeentry, err := client.SchemaRegistry.CreateType(ctx, "proj-abc", &schemaregistry.CreateTypeRequest{ TypeName: "ResearchPaper", Description: ptrString("An academic research paper"), JSONSchema: json.RawMessage(`{"title":{"type":"string"},"abstract":{"type":"string"}}`),})fmt.Println("Registered:", entry.Type)