---
title: Core Services
description: Core Services protocol schemas
---

{/* ⚠️  AUTO-GENERATED — DO NOT EDIT. Run build-docs.ts to regenerate. Hand-written docs go in content/docs/guides/. */}

# Service Registry Protocol

Defines the standard built-in services that constitute the ObjectStack Kernel.

This registry is used by the `ObjectKernel` and `HttpDispatcher` to:

1. Verify service availability.

2. Route requests to the correct service handler.

3. Type-check service interactions.

<Callout type="info">
**Source:** `packages/spec/src/system/core-services.zod.ts`
</Callout>

## TypeScript Usage

```typescript
import { CoreServiceName, KernelServiceMap, ServiceConfig, ServiceCriticality, ServiceStatus } from '@objectstack/spec/system';
import type { CoreServiceName, KernelServiceMap, ServiceConfig, ServiceCriticality, ServiceStatus } from '@objectstack/spec/system';

// Validate data
const result = CoreServiceName.parse(data);
```

---

## CoreServiceName

### Allowed Values

* `metadata`
* `data`
* `auth`
* `file-storage`
* `search`
* `cache`
* `queue`
* `automation`
* `graphql`
* `analytics`
* `realtime`
* `job`
* `notification`
* `ai`
* `i18n`
* `ui`
* `workflow`


---


---

## ServiceConfig

### Properties

| Property | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| **id** | `string` | ✅ |  |
| **name** | `Enum<'metadata' \| 'data' \| 'auth' \| 'file-storage' \| 'search' \| 'cache' \| 'queue' \| 'automation' \| 'graphql' \| 'analytics' \| 'realtime' \| 'job' \| 'notification' \| 'ai' \| 'i18n' \| 'ui' \| 'workflow'>` | ✅ |  |
| **options** | `Record<string, any>` | optional |  |


---

## ServiceCriticality

### Allowed Values

* `required`
* `core`
* `optional`


---

## ServiceStatus

### Properties

| Property | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| **name** | `Enum<'metadata' \| 'data' \| 'auth' \| 'file-storage' \| 'search' \| 'cache' \| 'queue' \| 'automation' \| 'graphql' \| 'analytics' \| 'realtime' \| 'job' \| 'notification' \| 'ai' \| 'i18n' \| 'ui' \| 'workflow'>` | ✅ |  |
| **enabled** | `boolean` | ✅ |  |
| **status** | `Enum<'running' \| 'stopped' \| 'degraded' \| 'initializing'>` | ✅ |  |
| **version** | `string` | optional |  |
| **provider** | `string` | optional | Implementation provider (e.g. "s3" for storage) |
| **features** | `string[]` | optional | List of supported sub-features |


---

