ObjectStackObjectStack

Protocol Reference

Every schema published by @objectstack/spec — 1570 schemas across 14 protocol modules

This is the complete reference for every protocol schema published by @objectstack/spec. Each protocol is defined as a Zod schema (Prime Directive #1), which is where its runtime validation, its TypeScript type and its JSON Schema all come from.

This index — like every page under it — is generated from the Zod sources in packages/spec/src/ by packages/spec/scripts/build-docs.ts. Its rows are enumerated from the same JSON Schema output the reference pages are built from, so a schema that no longer exists cannot keep a row here, and the counts are sums of the rows they head. Regenerate with pnpm --filter @objectstack/spec gen:schema && pnpm --filter @objectstack/spec gen:docs.

Quick Navigation

ModulePagesSchemasDescription
AI Protocol1166Agents, tools, skills, RAG and knowledge sources, model registry, conversations.
API Protocol28412REST/GraphQL contracts, endpoints, routing, realtime, batch, discovery.
Automation Protocol1368Flows and their nodes, approvals, ETL pipelines, webhooks, state machines, execution records.
Cloud Protocol1194Environments, packages and versions, marketplace, developer portal, tenancy.
Data Protocol29163Objects, fields, queries, filters, datasources and drivers — the ObjectQL layer.
Identity Protocol528Users and accounts, organizations, positions, API keys, SCIM provisioning.
Integration Protocol127The single connector protocol (ADR-0097) — catalog descriptors and provider-bound instances.
Kernel Protocol31176Plugin lifecycle and manifests, capabilities and security, metadata loading, service registry.
QA Protocol18Declarative test suites — scenarios, steps, actions and assertions.
Security Protocol527Permission sets, row-level security, sharing rules, tenancy posture.
Shared Protocol831Primitives used across every protocol — identifiers, HTTP, expressions, error maps, enums.
Studio Protocol335Studio designer metadata — the authoring surfaces for the protocols above.
System Protocol36287The runtime environment — logging, jobs, cache, metrics, notifications, i18n and compliance.
UI Protocol16148Apps, pages, views, dashboards, reports, actions and themes — the ObjectUI layer.
Total198157014 protocol modules

AI Protocol

Source: packages/spec/src/ai/ · Import: @objectstack/spec/ai · 11 pages, 66 schemas

Agents, tools, skills, RAG and knowledge sources, model registry, conversations.

FileSchemas
agent.zod.tsAIModelConfig, Agent, StructuredOutputConfig, StructuredOutputFormat, TransformPipelineStep
conversation.zod.tsCodeContent, ConversationAnalytics, ConversationContext, ConversationMessage, ConversationSession, ConversationSummary, FileContent, FunctionCall, ImageContent, MessageContent, MessageContentType, MessagePruningEvent, MessageRole, TextContent, TokenBudgetConfig, TokenBudgetStrategy, TokenUsageStats, ToolCall
embedding.zod.tsEmbeddingModel, VectorStore, VectorStoreProvider
knowledge-document.zod.tsKnowledgeChunk, KnowledgeDocument, KnowledgeHit
knowledge-source.zod.tsFileKnowledgeSource, HttpKnowledgeSource, KnowledgeRefreshPolicy, KnowledgeSource, KnowledgeSourceKind, ObjectKnowledgeSource
mcp.zod.tsMCPApprovalPolicy, MCPServerRef, MCPToolBinding, MCPTransport
model-registry.zod.tsModelCapability, ModelConfig, ModelLimits, ModelPricing, ModelProvider, ModelRegistry, ModelRegistryEntry, ModelSelectionCriteria, PromptTemplate, PromptVariable
skill.zod.tsSkill, SkillTriggerCondition
solution-blueprint.zod.tsBlueprintApp, BlueprintCondition, BlueprintDashboard, BlueprintField, BlueprintNavItem, BlueprintObject, BlueprintSeed, BlueprintSummaryOperations, BlueprintView, BlueprintWidgetCondition, SolutionBlueprint, SolutionBlueprintStrict
tool.zod.tsTool
usage.zod.tsAIUsageRecord, TokenUsage

API Protocol

Source: packages/spec/src/api/ · Import: @objectstack/spec/api · 28 pages, 412 schemas

REST/GraphQL contracts, endpoints, routing, realtime, batch, discovery.

FileSchemas
analytics.zod.tsAnalyticsEndpoint, AnalyticsMetadataResponse, AnalyticsQueryRequest, AnalyticsResultResponse, AnalyticsSqlResponse, GetAnalyticsMetaRequest
auth.zod.tsAuthProvider, LoginRequest, LoginType, RefreshTokenRequest, RegisterRequest, Session, SessionResponse, SessionUser, UserProfileResponse
auth-endpoints.zod.tsAuthEndpoint, AuthFeaturesConfig, AuthProviderInfo, DeviceRequestResponse, DeviceTokenResponse, EmailPasswordConfigPublic, GetAuthConfigResponse
automation-api.zod.tsAutomationApiErrorCode, AutomationFlowPathParams, AutomationRunPathParams, CreateFlowRequest, CreateFlowResponse, DeleteFlowRequest, DeleteFlowResponse, FlowSummary, GetFlowRequest, GetFlowResponse, GetRunRequest, GetRunResponse, ListFlowsRequest, ListFlowsResponse, ListRunsRequest, ListRunsResponse, ToggleFlowRequest, ToggleFlowResponse, TriggerFlowRequest, TriggerFlowResponse, UpdateFlowRequest, UpdateFlowResponse
batch.zod.tsBatchConfig, BatchOperationResult, BatchOperationType, BatchOptions, BatchRecord, BatchUpdateRequest, BatchUpdateResponse, CrossObjectBatchDroppedFields, CrossObjectBatchOperation, CrossObjectBatchRequest, CrossObjectBatchResponse, DeleteManyRequest, UpdateManyRecord, UpdateManyRequest
contract.zod.tsApiError, BaseResponse, BatchLoadingStrategy, BulkRequest, BulkResponse, CreateRequest, DataLoaderConfig, DeleteResponse, ExportRequest, IdRequest, ListRecordResponse, ModificationResult, QueryOptimizationConfig, RecordData, SingleRecordResponse, UpdateRequest
discovery.zod.tsApiRoutes, CapabilityDescriptor, Discovery, DiscoveryEnvironment, RouteHealthEntry, RouteHealthReport, ServiceInfo, ServiceSelfInfo, ServiceStatus, WellKnownCapabilities
dispatcher.zod.tsDispatcherConfig, DispatcherErrorCode, DispatcherErrorResponse, DispatcherRoute
documentation.zod.tsApiChangelogEntry, ApiDocumentationConfig, ApiTestCollection, ApiTestRequest, ApiTestingUiConfig, ApiTestingUiType, CodeGenerationTemplate, GeneratedApiDocumentation, OpenApiSecurityScheme, OpenApiServer, OpenApiSpec
endpoint.zod.tsApiEndpoint, ApiMapping
error-code-ledger.zod.tsErrorCode
errors.zod.tsEnhancedApiError, ErrorCategory, ErrorResponse, FieldError, FieldErrorCode, RetryStrategy, StandardErrorCode
events.zod.tsBulkDataEvent, BulkDataEventType, DataEvent, DataEventType, MetadataEvent, MetadataEventType
export.zod.tsCreateExportJobRequest, CreateExportJobResponse, CreateImportJobRequest, CreateImportJobResponse, DeduplicationStrategy, ExportFormat, ExportImportTemplate, ExportJobProgress, ExportJobStatus, ExportJobSummary, FieldMappingEntry, GetExportJobDownloadRequest, GetExportJobDownloadResponse, ImportJobProgress, ImportJobResults, ImportJobStatus, ImportJobSummary, ImportMapping, ImportRequest, ImportResponse, ImportRowResult, ImportValidationConfig, ImportValidationMode, ImportValidationResult, ImportWriteMode, ListExportJobsRequest, ListExportJobsResponse, ListImportJobsRequest, ListImportJobsResponse, ScheduleExportRequest, ScheduleExportResponse, ScheduledExport, UndoImportJobResponse
http-cache.zod.tsCacheControl, CacheDirective, CacheInvalidationRequest, CacheInvalidationResponse, CacheInvalidationTarget, ETag, MetadataCacheRequest, MetadataCacheResponse
metadata.zod.tsAppDefinitionResponse, ConceptListResponse, MetadataBulkRegisterRequest, MetadataBulkResponse, MetadataBulkUnregisterRequest, MetadataDeleteResponse, MetadataDependenciesResponse, MetadataDependentsResponse, MetadataEffectiveResponse, MetadataExistsResponse, MetadataExportRequest, MetadataExportResponse, MetadataImportRequest, MetadataImportResponse, MetadataItemResponse, MetadataListResponse, MetadataNamesResponse, MetadataOverlayResponse, MetadataOverlaySaveRequest, MetadataQueryRequest, MetadataQueryResponse, MetadataRegisterRequest, MetadataTypeInfoResponse, MetadataTypesResponse, MetadataValidateRequest, MetadataValidateResponse, ObjectDefinitionResponse
odata.zod.tsODataConfig, ODataError, ODataFilterFunction, ODataMetadata, ODataQuery, ODataResponse
package-api.zod.tsGetInstalledPackageRequest, GetInstalledPackageResponse, ListInstalledPackagesRequest, ListInstalledPackagesResponse, PackageApiErrorCode, PackageInstallRequest, PackageInstallResponse, PackagePathParams, PackageRollbackRequest, PackageRollbackResponse, PackageUpgradeRequest, PackageUpgradeResponse, ResolveDependenciesRequest, ResolveDependenciesResponse, UninstallPackageApiRequest, UninstallPackageApiResponse, UploadArtifactRequest, UploadArtifactResponse
plugin-rest-api.zod.tsErrorHandlingConfig, HandlerStatus, OpenApiGenerationConfig, RequestValidationConfig, ResponseEnvelopeConfig, RestApiEndpoint, RestApiPluginConfig, RestApiRouteCategory, RestApiRouteRegistration, RouteCoverageEntry, RouteCoverageReport, ValidationMode
protocol.zod.tsAiAgentCapabilities, AiAgentChatRequest, AiAgentSummary, AiAgentsResponse, AiChatRequest, AiChatResponse, AiCompleteRequest, AiConversation, AiMessage, AiModelsResponse, AiPendingAction, AiPendingActionStatus, AiStreamChunk, ApproveAiPendingActionResponse, AutomationActionsResponse, AutomationTriggerRequest, AutomationTriggerResponse, BatchDataRequest, BatchDataResponse, CheckPermissionRequest, CheckPermissionResponse, CreateAiConversationRequest, CreateDataRequest, CreateDataResponse, CreateManyDataRequest, CreateManyDataResponse, DeleteDataRequest, DeleteDataResponse, DeleteManyDataRequest, DeleteManyDataResponse, DeleteMetaItemRequest, DeleteMetaItemResponse, DisablePackageRequest, DisablePackageResponse, EnablePackageRequest, EnablePackageResponse, FindDataRequest, FindDataResponse, GetDataRequest, GetDataResponse, GetDiscoveryRequest, GetDiscoveryResponse, GetEffectivePermissionsRequest, GetEffectivePermissionsResponse, GetFieldLabelsRequest, GetFieldLabelsResponse, GetLocalesRequest, GetLocalesResponse, GetMetaItemCachedRequest, GetMetaItemCachedResponse, GetMetaItemLayeredResponse, GetMetaItemRequest, GetMetaItemResponse, GetMetaItemsRequest, GetMetaItemsResponse, GetMetaTypesRequest, GetMetaTypesResponse, GetNotificationPreferencesRequest, GetNotificationPreferencesResponse, GetObjectPermissionsRequest, GetObjectPermissionsResponse, GetPackageRequest, GetPackageResponse, GetPresenceRequest, GetPresenceResponse, GetTranslationsRequest, GetTranslationsResponse, GetUiViewRequest, GetUiViewResponse, HttpFindQueryParams, InstallPackageRequest, InstallPackageResponse, ListAiConversationsRequest, ListAiConversationsResponse, ListAiPendingActionsRequest, ListAiPendingActionsResponse, ListNotificationsRequest, ListNotificationsResponse, ListPackagesRequest, ListPackagesResponse, MarkAllNotificationsReadRequest, MarkAllNotificationsReadResponse, MarkNotificationsReadRequest, MarkNotificationsReadResponse, Notification, NotificationPreferences, PublishMetaItemResponse, RealtimeConnectRequest, RealtimeConnectResponse, RealtimeDisconnectRequest, RealtimeDisconnectResponse, RealtimeSubscribeRequest, RealtimeSubscribeResponse, RealtimeUnsubscribeRequest, RealtimeUnsubscribeResponse, RegisterDeviceRequest, RegisterDeviceResponse, RejectAiPendingActionResponse, RuntimeAuthoringIssue, SaveMetaItemRequest, SaveMetaItemResponse, SetPresenceRequest, SetPresenceResponse, UninstallPackageRequest, UninstallPackageResponse, UnregisterDeviceRequest, UnregisterDeviceResponse, UpdateAiConversationRequest, UpdateDataRequest, UpdateDataResponse, UpdateManyDataRequest, UpdateManyDataResponse, UpdateNotificationPreferencesRequest, UpdateNotificationPreferencesResponse, ValidateDataIssue, ValidateDataRequest, ValidateDataResponse
query-adapter.zod.tsODataQueryAdapter, OperatorMapping, QueryAdapterConfig, QueryAdapterTarget, RestQueryAdapter
realtime.zod.tsRealtimeConfig, RealtimeEvent, RealtimeEventType, RealtimePresence, Subscription, SubscriptionEvent, TransportProtocol
realtime-shared.zod.tsBasePresence, PresenceStatus, RealtimeRecordAction
rest-server.zod.tsBatchEndpointsConfig, CrudEndpointPattern, CrudEndpointsConfig, CrudOperation, EndpointRegistry, GeneratedEndpoint, MetadataEndpointsConfig, RestApiConfig, RestServerConfig, RouteGenerationConfig
router.zod.tsConflictResolutionStrategy, HttpMethod, RouteCategory, RouteDefinition, RouterConfig
storage.zod.tsCompleteChunkedUploadRequest, CompleteChunkedUploadResponse, CompleteUploadRequest, FileDownloadUrlResponse, FileTypeValidation, FileUploadResponse, GetPresignedUrlRequest, InitiateChunkedUploadRequest, InitiateChunkedUploadResponse, PresignedUrlResponse, RawUploadResponse, UploadChunkRequest, UploadChunkResponse, UploadProgress
versioning.zod.tsVersionDefinition, VersionNegotiationResponse, VersionStatus, VersioningConfig, VersioningStrategy
websocket.zod.tsAckMessage, CursorMessage, CursorPosition, DocumentState, EditMessage, EditOperation, EditOperationType, ErrorMessage, EventMessage, EventPattern, EventSubscription, PingMessage, PongMessage, PresenceMessage, PresenceState, PresenceUpdate, SimpleCursorPosition, SimplePresenceState, SubscribeMessage, UnsubscribeMessage, UnsubscribeRequest, WebSocketConfig, WebSocketEvent, WebSocketMessage, WebSocketMessageType, WebSocketPresenceStatus, WebSocketServerConfig

Automation Protocol

Source: packages/spec/src/automation/ · Import: @objectstack/spec/automation · 13 pages, 68 schemas

Flows and their nodes, approvals, ETL pipelines, webhooks, state machines, execution records.

FileSchemas
approval.zod.tsApprovalDecision, ApprovalEscalation, ApprovalNodeApprover, ApprovalNodeConfig, ApproverType, DecisionOutputDef
bpmn-interop.zod.tsBpmnDiagnostic, BpmnElementMapping, BpmnExportOptions, BpmnImportOptions, BpmnInteropResult, BpmnUnmappedStrategy, BpmnVersion
builtin-node-config.zod.tsCreateRecordConfig, DeleteRecordConfig, GetRecordConfig, MapConfig, ScreenConfig, ScreenFieldConfig, UpdateRecordConfig
control-flow.zod.tsFlowRegion, LoopConfig, ParallelBranch, ParallelConfig, RetryPolicy, TryCatchConfig
execution.zod.tsCheckpoint, ConcurrencyPolicy, ExecutionError, ExecutionErrorSeverity, ExecutionLog, ExecutionStatus, ExecutionStepLog, ExecutionStepMetrics, ExecutionStepSkipReason, FlowRunGateSummary, FlowRunNodeSummary, FlowRunSummary, ScheduleState
flow.zod.tsFlow, FlowEdge, FlowNode, FlowNodeAction, FlowVariable, FlowVersionHistory
flow-function.zod.tsFlowFunctionEffect
io-node-config.zod.tsHttpConfig, NotifyConfig
node-executor.zod.tsActionCategory, ActionDescriptor, ActionParadigm, NodeExecutorDescriptor, WaitEventType, WaitExecutorConfig, WaitResumePayload, WaitTimeoutBehavior
schemaless-node-config.zod.tsDecisionCondition, DecisionConfig, ScriptConfig, SubflowConfig
state-machine.zod.tsActionRef, GuardRef, StateMachine, StateNode, Transition
time-relative-trigger.zod.tsTimeRelativeTrigger
webhook.zod.tsWebhook, WebhookTriggerType

Cloud Protocol

Source: packages/spec/src/cloud/ · Import: @objectstack/spec/cloud · 11 pages, 94 schemas

Environments, packages and versions, marketplace, developer portal, tenancy.

FileSchemas
app-store.zod.tsAppDiscoveryRequest, AppDiscoveryResponse, AppSubscription, InstalledAppSummary, ListInstalledAppsRequest, ListInstalledAppsResponse, ListReviewsRequest, ListReviewsResponse, RecommendationReason, RecommendedApp, ReviewModerationStatus, SubmitReviewRequest, SubscriptionStatus, UserReview
developer-portal.zod.tsAnalyticsTimeRange, CreateListingRequest, ListingActionRequest, PublisherProfile, PublishingAnalyticsRequest, PublishingAnalyticsResponse, ReleaseChannel, TimeSeriesPoint, UpdateListingRequest, VersionRelease
environment.zod.tsEnvironment, EnvironmentCredential, EnvironmentCredentialStatus, EnvironmentDriver, EnvironmentMember, EnvironmentRole, EnvironmentStatus, EnvironmentType, EnvironmentVisibility, ProvisionEnvironmentRequest, ProvisionEnvironmentResponse, ProvisionOrganizationRequest, ProvisionOrganizationResponse
environment-artifact.zod.tsSha256Digest
environment-package.zod.tsEnvironmentPackageInstallation, EnvironmentPackageStatus, InstallPackageToEnvironmentRequest, ListEnvironmentPackagesResponse, RollbackEnvironmentPackageRequest, UpgradeEnvironmentPackageRequest
marketplace.zod.tsArtifactDownloadResponse, ArtifactReference, ListingStatus, MarketplaceCategory, MarketplaceInstallRequest, MarketplaceInstallResponse, MarketplaceListing, MarketplaceSearchRequest, MarketplaceSearchResponse, PackageSubmission, PricingModel, Publisher, PublisherVerification
marketplace-admin.zod.tsCuratedCollection, FeaturedListing, MarketplaceHealthMetrics, PolicyAction, PolicyViolationType, RejectionReason, ReviewCriterion, ReviewDecision, SubmissionReview, TrendingListing
package.zod.tsCreatePackageRequest, Package, PackageCategory, PackageLocale, PackagePublisher, PackageTranslation, PackageTranslations, PackageVisibility, UpdatePackageRequest
package-version.zod.tsCreatePackageVersionRequest, PackageDependency, PackageManifest, PackageVersion, PackageVersionStatus, PublishPackageVersionRequest, UpdatePackageVersionRequest
template-manifest.zod.tsTemplateManifest
tenant.zod.tsPackageInstallation, PackageInstallationStatus, ProvisionTenantRequest, ProvisionTenantResponse, TenantContext, TenantDatabase, TenantDatabaseStatus, TenantIdentificationSource, TenantPlan, TenantRoutingConfig

Data Protocol

Source: packages/spec/src/data/ · Import: @objectstack/spec/data · 29 pages, 163 schemas

Objects, fields, queries, filters, datasources and drivers — the ObjectQL layer.

FileSchemas
analytics.zod.tsAggregationMetricType, AnalyticsQuery, Cube, CubeJoin, Dimension, DimensionType, Metric, TimeUpdateInterval
context-tokens.zod.tsContextToken, ContextTokenPlaceholder
data-engine.zod.tsBaseEngineOptions, DataEngineAggregateOptions, DataEngineAggregateRequest, DataEngineCountOptions, DataEngineCountRequest, DataEngineDeleteOptions, DataEngineDeleteRequest, DataEngineExecuteRequest, DataEngineFilter, DataEngineFindOneRequest, DataEngineFindRequest, DataEngineInsertOptions, DataEngineInsertRequest, DataEngineQueryOptions, DataEngineRequest, DataEngineSort, DataEngineUpdateOptions, DataEngineUpdateRequest, DataEngineVectorFindRequest, DroppedFieldsEvent, EngineAggregateOptions, EngineCountOptions, EngineDeleteOptions, EngineQueryOptions, EngineUpdateOptions
datasource.zod.tsDatasource, DriverDefinition, DriverType, ExternalDatasourceSettings, SchemaMode
date-macros.zod.tsDateMacroPlaceholder, DateMacroToken
document.zod.tsDocument, DocumentTemplate, DocumentVersion, ESignatureConfig
driver.zod.tsDriverCapabilities, DriverConfig, DriverOptions, PoolConfig
driver/common.zod.tsDriverSslToggle, SqlAutoMigrate
driver/memory.zod.tsAutoPersistenceConfig, FilePersistenceConfig, LocalStoragePersistenceConfig, PersistenceType
driver/mongo.zod.tsMongoConfig
driver/mysql.zod.tsMysqlConfig
driver-nosql.zod.tsAggregationPipeline, AggregationStage, ConsistencyLevel, DocumentSchemaValidation, NoSQLDataTypeMapping, NoSQLDatabaseType, NoSQLDriverConfig, NoSQLIndex, NoSQLIndexType, NoSQLOperationType, NoSQLQueryOptions, NoSQLTransactionOptions, ReplicationConfig, ShardingConfig
driver/postgres.zod.tsPostgresConfig
driver-sql.zod.tsDataTypeMapping, SQLDialect, SQLDriverConfig, SSLConfig
driver/sqlite.zod.tsSqliteConfig, SqliteWasmConfig, SqliteWasmPersistMode
driver/turso.zod.tsTursoConfig, TursoTransportMode
external-catalog.zod.tsExternalCatalog, ExternalColumn, ExternalTable
feed.zod.tsFeedFilterMode, FeedItemType
field.zod.tsCurrencyConfig, CurrencyValue, Field, FieldType, LocationCoordinates, SelectOption, UniqueScope
field-value.zod.tsAddress, AddressValue, CalendarDateValue, ClockTimeValue, FileLikeValue, FileReferenceIdValue, FileValue, InstantValue, LocationValue, ReferenceIdValue
filter.zod.tsEqualityOperator, FieldReference, FilterArray, FilterCondition, QueryFilter, SetOperator, SpecialOperator, StringOperator
hook.zod.tsHookContext, HookEvent
hook-body.zod.tsExpressionBody, HookBody, HookBodyCapability, ScriptBody
mapping.zod.tsImportFieldMapping, Mapping, TransformType
object.zod.tsApiMethod, ApiOperation, Index, Lifecycle, LifecycleClass, Object, ObjectAccessConfig, ObjectCapabilities, ObjectExtension, ObjectExternalBinding, ObjectFieldGroup, ObjectOwnershipEnum, ObjectRequiredPermissions, PerOperationRequiredPermissions, RowCrudActionOverride, TenancyConfig
query.zod.tsAggregationFunction, AggregationNode, DateGranularity, FieldNode, FullTextSearch, GroupByNode, Query, SortNode
seed.zod.tsSeed, SeedMode
seed-loader.zod.tsObjectDependencyGraph, ObjectDependencyNode, ReferenceResolution, ReferenceResolutionError, SeedIdentity, SeedLoadResult, SeedLoaderConfig, SeedLoaderRequest, SeedLoaderResult
validation.zod.tsConditionalValidation, CrossFieldValidation, FormatValidation, JSONValidation, ScriptValidation, StateMachineValidation, ValidationRule

Identity Protocol

Source: packages/spec/src/identity/ · Import: @objectstack/spec/identity · 5 pages, 28 schemas

Users and accounts, organizations, positions, API keys, SCIM provisioning.

FileSchemas
eval-user.zod.tsEvalUser
identity.zod.tsAccount, ApiKey, User, VerificationToken
organization.zod.tsInvitation, InvitationStatus, Member, Organization
position.zod.tsPosition
scim.zod.tsSCIMAddress, SCIMBulkOperation, SCIMBulkRequest, SCIMBulkResponse, SCIMBulkResponseOperation, SCIMEmail, SCIMEnterpriseUser, SCIMError, SCIMGroup, SCIMGroupReference, SCIMListResponse, SCIMMemberReference, SCIMMeta, SCIMName, SCIMPatchOperation, SCIMPatchRequest, SCIMPhoneNumber, SCIMUser

Integration Protocol

Source: packages/spec/src/integration/ · Import: @objectstack/spec/integration · 1 page, 27 schemas

The single connector protocol (ADR-0097) — catalog descriptors and provider-bound instances.

FileSchemas
connector.zod.tsCircuitBreakerConfig, Connector, ConnectorAction, ConnectorActionEffect, ConnectorConflictResolution, ConnectorErrorCategory, ConnectorFieldMapping, ConnectorHealth, ConnectorInstanceAPIKeyAuth, ConnectorInstanceAuth, ConnectorInstanceBasicAuth, ConnectorInstanceBearerAuth, ConnectorInstanceNoAuth, ConnectorRetryStrategy, ConnectorStatus, ConnectorTrigger, ConnectorType, DataSyncConfig, DeclarativeConnectorEntry, ErrorMappingConfig, ErrorMappingRule, HealthCheckConfig, RetryConfig, SyncStrategy, WebhookConfig, WebhookEvent, WebhookSignatureAlgorithm

Kernel Protocol

Source: packages/spec/src/kernel/ · Import: @objectstack/spec/kernel · 31 pages, 176 schemas

Plugin lifecycle and manifests, capabilities and security, metadata loading, service registry.

FileSchemas
cli-extension.zod.tsCLICommandContribution, OclifPluginConfig
cluster.zod.tsClusterCapabilityConfig, ClusterDriver, ClusterTenantIsolation, EventClusterOptions, EventDeliverySemantics, EventScope, MetadataChangeOperation, ServiceClusterAnnotations, ServiceClusterScope, ServiceLeaderStrategy
context.zod.tsKernelContext, PreviewModeConfig, RuntimeMode, TenantRuntimeContext
dependency-resolution.zod.tsDependencyResolutionResult, DependencyStatusEnum, RequiredAction, ResolvedDependency
events/bus.zod.tsEventBusConfig
events/core.zod.tsEvent, EventMetadata, EventPriority, EventTypeDefinition
events/dlq.zod.tsDeadLetterQueueEntry, EventLogEntry
events/handlers.zod.tsEventHandler, EventPersistence, EventRoute
events/integrations.zod.tsEventMessageQueueConfig, EventWebhookConfig, RealTimeNotificationConfig
events/queue.zod.tsEventQueueConfig, EventReplayConfig, EventSourcingConfig
execution-context.zod.tsExecutionContext
manifest.zod.tsManifest, ManifestPermissions, PluginEngines, PluginIntegrity, PluginPackaging, PluginPermissions, PluginRuntime
metadata-customization.zod.tsCustomizationOrigin, CustomizationPolicy, FieldChange, MergeConflict, MergeResult, MergeStrategyConfig, MetadataOverlay
metadata-loader.zod.tsMetadataFallbackStrategy, MetadataManagerConfig
metadata-plugin.zod.tsMetadataBulkResult, MetadataDependency, MetadataPluginConfig, MetadataPluginManifest, MetadataQuery, MetadataQueryResult, MetadataType, MetadataTypeRegistryEntry, MetadataValidationResult
metadata-protection.zod.tsMetadataLock, MetadataLockSource, MetadataProvenance
package-artifact.zod.tsArtifactChecksum, ArtifactFileEntry, ArtifactSignature, MetadataCategoryEnum, PackageArtifact
package-registry.zod.tsDisablePackageRequest, DisablePackageResponse, EnablePackageRequest, EnablePackageResponse, GetPackageRequest, GetPackageResponse, InstallPackageRequest, InstallPackageResponse, InstalledPackage, ListPackagesRequest, ListPackagesResponse, NamespaceConflictError, NamespaceRegistryEntry, PackageStatusEnum, UninstallPackageRequest, UninstallPackageResponse
package-upgrade.zod.tsMetadataChangeType, MetadataDiffItem, RollbackPackageRequest, RollbackPackageResponse, UpgradeImpactLevel, UpgradePackageRequest, UpgradePackageResponse, UpgradePhase, UpgradePlan, UpgradeSnapshot
plugin.zod.tsPlugin
plugin-capability.zod.tsCapabilityConformanceLevel, ExtensionPoint, PluginCapability, PluginCapabilityManifest, PluginDependency, PluginInterface, ProtocolFeature, ProtocolReference, ProtocolVersion
plugin-lifecycle-advanced.zod.tsAdvancedPluginLifecycleConfig, DistributedStateConfig, GracefulDegradation, HotReloadConfig, PluginHealthCheck, PluginHealthReport, PluginHealthStatus, PluginStateSnapshot, PluginUpdateStrategy
plugin-loading.zod.tsPluginLoadingEvent, PluginLoadingState
plugin-registry.zod.tsPluginInstallConfig, PluginQualityMetrics, PluginRegistryEntry, PluginSearchFilters, PluginStatistics, PluginVendor
plugin-security.zod.tsDependencyGraph, DependencyGraphNode, PackageDependencyConflict, PackageDependencyResolutionResult, PluginProvenance, PluginTrustScore, ResolvedPackageDependency, SBOM, SBOMEntry, SecurityPolicy, SecurityScanResult, SecurityVulnerability, VulnerabilitySeverity
plugin-security-advanced.zod.tsKernelSecurityPolicy, KernelSecurityScanResult, KernelSecurityVulnerability, PermissionAction, PermissionScope, PluginPermission, PluginPermissionSet, PluginSecurityManifest, PluginTrustLevel, ResourceType, RuntimeConfig, SandboxConfig
plugin-structure.zod.tsOpsDomainModule, OpsFilePath, OpsPluginStructure
plugin-validator.zod.tsPluginMetadata, ValidationError, ValidationResult, ValidationWarning
plugin-versioning.zod.tsBreakingChange, CompatibilityLevel, CompatibilityMatrixEntry, DependencyConflict, DeprecationNotice, MultiVersionSupport, PluginCompatibilityMatrix, PluginDependencyResolutionResult, PluginVersionMetadata, SemanticVersion, VersionConstraint
service-registry.zod.tsScopeConfig, ScopeInfo, ServiceFactoryRegistration, ServiceMetadata, ServiceRegistryConfig, ServiceScopeType
startup-orchestrator.zod.tsHealthStatus, PluginStartupResult, StartupOptions, StartupOrchestrationResult

QA Protocol

Source: packages/spec/src/qa/ · Import: @objectstack/spec/qa · 1 page, 8 schemas

Declarative test suites — scenarios, steps, actions and assertions.

FileSchemas
testing.zod.tsTestAction, TestActionType, TestAssertion, TestAssertionType, TestContext, TestScenario, TestStep, TestSuite

Security Protocol

Source: packages/spec/src/security/ · Import: @objectstack/spec/security · 5 pages, 27 schemas

Permission sets, row-level security, sharing rules, tenancy posture.

FileSchemas
explain.zod.tsAccessMatrix, AccessMatrixEntry, AuthzPosture, ExplainDecision, ExplainLayer, ExplainMatchedRule, ExplainOperation, ExplainRecordAttribution, ExplainRequest
misc (no single source file)CapabilityDeclaration, TenancyPosture
permission.zod.tsAdminScope, EffectiveObjectPermission, FieldPermission, ObjectAccessScope, ObjectPermission, PermissionSet
rls.zod.tsRLSEvaluationResult, RLSOperation, RLSUserContext, RowLevelSecurityPolicy
sharing.zod.tsCriteriaSharingRule, OWDModel, ShareRecipientType, SharingLevel, SharingRule, SharingRuleType

Shared Protocol

Source: packages/spec/src/shared/ · Import: @objectstack/spec/shared · 8 pages, 31 schemas

Primitives used across every protocol — identifiers, HTTP, expressions, error maps, enums.

FileSchemas
branded-types.zod.tsAppName, FieldName, FlowName, ObjectName, RoleName, ViewName
enums.zod.tsIsolationLevelEnum, MutationEventEnum, SortDirectionEnum, SortItem
expression.zod.tsCronExpressionInput, Expression, ExpressionDialect, ExpressionInput, ExpressionMeta, Predicate, PredicateInput, TemplateExpressionInput
http.zod.tsCorsConfig, HttpMethod, HttpMethodSubset, HttpRequest, RateLimitConfig, StaticMount
identifiers.zod.tsEventName, SnakeCaseIdentifier, SystemIdentifier
mapping.zod.tsFieldMapping
metadata-types.zod.tsBaseMetadataRecord, MetadataFormat
protection.zod.tsProtection

Studio Protocol

Source: packages/spec/src/studio/ · Import: @objectstack/spec/studio · 3 pages, 35 schemas

Studio designer metadata — the authoring surfaces for the protocols above.

FileSchemas
flow-builder.zod.tsFlowBuilderConfig, FlowCanvasEdge, FlowCanvasEdgeStyle, FlowCanvasNode, FlowLayoutAlgorithm, FlowLayoutDirection, FlowNodeRenderDescriptor, FlowNodeShape
object-designer.zod.tsERDiagramConfig, ERLayoutAlgorithm, ERNodeDisplay, FieldEditorConfig, FieldGroup, FieldPropertySection, ObjectDesignerConfig, ObjectDesignerDefaultView, ObjectFilter, ObjectListDisplayMode, ObjectManagerConfig, ObjectPreviewConfig, ObjectPreviewTab, ObjectSortField, RelationshipDisplay, RelationshipMapperConfig
plugin.zod.tsActionContribution, ActionContributionLocation, CommandContribution, MetadataIconContribution, MetadataViewerContribution, PanelContribution, PanelLocation, SidebarGroupContribution, StudioPluginContributions, StudioPluginManifest, ViewMode

System Protocol

Source: packages/spec/src/system/ · Import: @objectstack/spec/system · 36 pages, 287 schemas

The runtime environment — logging, jobs, cache, metrics, notifications, i18n and compliance.

FileSchemas
app-install.zod.tsAppCompatibilityCheck, AppInstallRequest, AppInstallResult, AppManifest
auth-config.zod.tsAdvancedAuthConfig, AuthConfig, AuthPluginConfig, AuthProviderConfig, EmailAndPasswordConfig, EmailVerificationConfig, MutualTLSConfig, OidcProviderConfig, OidcProvidersConfig, SocialProviderConfig
book.zod.tsBook, BookAudience, BookGroup, BookInclude, BookNode
cache.zod.tsCacheAvalanchePrevention, CacheConfig, CacheConsistency, CacheInvalidation, CacheStrategy, CacheTier, CacheWarmup, DistributedCacheConfig
change-management.zod.tsChangeImpact, ChangePriority, ChangeRequest, ChangeStatus, ChangeType, RollbackPlan
collaboration.zod.tsAwarenessEvent, AwarenessSession, AwarenessUpdate, AwarenessUserState, CRDTMergeResult, CRDTState, CRDTType, CollaborationMode, CollaborationSession, CollaborationSessionConfig, CollaborativeCursor, CounterOperation, CursorColorPreset, CursorSelection, CursorStyle, CursorUpdate, GCounter, LWWRegister, ORSet, ORSetElement, OTComponent, OTOperation, OTOperationType, OTTransformResult, PNCounter, TextCRDTOperation, TextCRDTState, UserActivityStatus, VectorClock
core-services.zod.tsCoreServiceName, KernelServiceMap, KernelServiceStatus, ServiceConfig, ServiceCriticality
deploy-bundle.zod.tsDeployBundle, DeployDiff, DeployManifest, DeployStatusEnum, DeployValidationIssue, DeployValidationResult, MigrationPlan, MigrationStatement, SchemaChange
disaster-recovery.zod.tsBackupConfig, BackupRetention, BackupStrategy, DisasterRecoveryPlan, FailoverConfig, FailoverMode, RPO, RTO
doc.zod.tsDoc
email-config.zod.tsEmailAddressConfig, EmailProvider, EmailServiceConfig
email-template.zod.tsEmailTemplateDefinition, EmailTemplateDefinitionCategory, EmailTemplateDefinitionVariable
encryption.zod.tsEncryptionAlgorithm, EncryptionConfig, FieldEncryption, KeyManagementProvider, KeyRotationPolicy
environment-artifact.zod.tsSha256Digest
http-server.zod.tsMiddlewareConfig, MiddlewareType, RouteHandlerMetadata
incident-response.zod.tsIncident, IncidentCategory, IncidentNotificationMatrix, IncidentNotificationRule, IncidentResponsePhase, IncidentResponsePolicy, IncidentSeverity, IncidentStatus
job.zod.tsCronSchedule, IntervalSchedule, Job, JobExecution, JobExecutionStatus, OnceSchedule, RetryPolicy, Schedule
license.zod.tsFeature, License, LicenseMetricType, Plan
logging.zod.tsConsoleDestinationConfig, ExtendedLogLevel, ExternalServiceDestinationConfig, FileDestinationConfig, HttpDestinationConfig, LogDestination, LogDestinationType, LogEnrichmentConfig, LogEntry, LogFormat, LogLevel, LoggerConfig, LoggingConfig, StructuredLogEntry
metadata-persistence.zod.tsMetadataCollectionInfo, MetadataDiffResult, MetadataFallbackStrategy, MetadataFormat, MetadataHistoryQueryOptions, MetadataHistoryQueryResult, MetadataHistoryRecord, MetadataHistoryRetentionPolicy, MetadataLoadOptions, MetadataLoadResult, MetadataLoaderContract, MetadataManagerConfig, MetadataRecord, MetadataSaveOptions, MetadataSaveResult, MetadataScope, MetadataSource, MetadataState, MetadataStats, MetadataWatchEvent, PackagePublishResult
metrics.zod.tsHistogramBucketConfig, MetricAggregationConfig, MetricAggregationType, MetricDataPoint, MetricDefinition, MetricExportConfig, MetricLabels, MetricType, MetricUnit, MetricsConfig, ServiceLevelIndicator, ServiceLevelObjective, TimeSeries, TimeSeriesDataPoint
migration.zod.tsAddFieldOperation, ChangeSet, CreateObjectOperation, DataMigrationFlag, DeleteObjectOperation, ExecuteSqlOperation, MigrationDependency, MigrationJournalEvent, MigrationOperation, ModifyFieldOperation, RemoveFieldOperation, RenameObjectOperation
notification.zod.tsNotificationChannel
object-storage.zod.tsAccessControlConfig, BucketConfig, FileMetadata, LifecycleAction, LifecyclePolicyConfig, LifecyclePolicyRule, MultipartUploadConfig, ObjectMetadata, ObjectStorageConfig, PresignedUrlConfig, StorageAcl, StorageClass, StorageConnection, StorageProvider, StorageScope
registry-config.zod.tsRegistryConfig, RegistrySyncPolicy, RegistryUpstream
search-engine.zod.tsAnalyzerConfig, FacetConfig, SearchConfig, SearchIndexConfig, SearchProvider
security-context.zod.tsComplianceAuditRequirement, ComplianceEncryptionRequirement, ComplianceFramework, DataClassification, DataClassificationPolicy, MaskingVisibilityRule, SecurityContextConfig, SecurityEventCorrelation
settings-client.zod.tsSettingsChangeEvent
settings-manifest.zod.tsResolvedSettingValue, SettingsActionResult, SettingsManifest, SettingsNamespacePayload, Specifier, SpecifierHandler, SpecifierOption, SpecifierScope, SpecifierType, SpecifierValueDomain
stack-server.zod.tsServerRateLimitConfig, StackServerConfig, StackServerSecurity
supplier-security.zod.tsSupplierAssessmentStatus, SupplierRiskLevel, SupplierSecurityAssessment, SupplierSecurityPolicy, SupplierSecurityRequirement
tenant.zod.tsDatabaseLevelIsolationStrategy, DatabaseProvider, QuotaEnforcementResult, RowLevelIsolationStrategy, SchemaLevelIsolationStrategy, Tenant, TenantConnectionConfig, TenantIsolationConfig, TenantIsolationLevel, TenantQuota, TenantSecurityPolicy, TenantUsage
tracing.zod.tsOpenTelemetryCompatibility, OtelExporterType, SamplingDecision, SamplingStrategyType, Span, SpanAttributeValue, SpanAttributes, SpanEvent, SpanKind, SpanLink, SpanStatus, TraceContext, TraceContextPropagation, TraceFlags, TracePropagationFormat, TraceSamplingConfig, TraceState, TracingConfig
training.zod.tsTrainingCategory, TrainingCompletionStatus, TrainingCourse, TrainingPlan, TrainingRecord
translation.zod.tsActionResultDialogTranslation, CoverageBreakdownEntry, FieldTranslation, Locale, ObjectTranslationData, TranslationBundle, TranslationConfig, TranslationCoverageResult, TranslationData, TranslationDiffItem, TranslationDiffStatus, TranslationItem
worker.zod.tsBatchProgress, QueueConfig, Task, TaskExecutionResult, TaskPriority, TaskRetryPolicy, TaskStatus, WorkerStats

UI Protocol

Source: packages/spec/src/ui/ · Import: @objectstack/spec/ui · 16 pages, 148 schemas

Apps, pages, views, dashboards, reports, actions and themes — the ObjectUI layer.

FileSchemas
action.zod.tsAction, ActionAi, ActionLocation, ActionParam, ActionType, InlineAction
action-params.zod.tsActionSession
app.zod.tsActionNavItem, App, AppBranding, AppContextSelector, ComponentNavItem, DashboardNavItem, GroupNavItem, NavigationArea, NavigationContribution, NavigationItem, ObjectNavItem, PageNavItem, ReportNavItem, UrlNavItem
bulk-action.zod.tsBulkActionDef, BulkActionExecution, BulkActionOperation, BulkActionParam
chart.zod.tsChartAggregate, ChartAggregateFunction, ChartAnnotation, ChartAxis, ChartConfig, ChartDrillDown, ChartGroupBy, ChartInteraction, ChartSeries, ChartType
component.zod.tsAIChatWindowProps, ElementButtonProps, ElementFilterProps, ElementFormProps, ElementImageProps, ElementMetadataViewerProps, ElementNumberProps, ElementRecordPickerProps, ElementTextInputProps, ElementTextProps, PageAccordionProps, PageCardProps, PageContainerProps, PageHeaderProps, PageTabsProps, RecordActivityProps, RecordChatterProps, RecordDetailsProps, RecordHighlightsField, RecordHighlightsProps, RecordPathProps, RecordRelatedListProps
dashboard.zod.tsDashboard, DashboardHeader, DashboardHeaderAction, DashboardWidget, DashboardWidgetOptions, GlobalFilter, GlobalFilterOptionsFrom, WidgetActionType, WidgetColorVariant
dataset.zod.tsDataset, DatasetDimension, DatasetMeasure, DerivedMeasureOp
i18n.zod.tsAriaProps, I18nLabel, InlineLocaleMap
notification.zod.tsNotificationPosition, NotificationSeverity, NotificationType
page.zod.tsElementDataSource, InterfacePageConfig, Page, PageComponent, PageComponentType, PageRegion, PageType, PageVariable
report.zod.tsJoinedReportBlock, Report, ReportChart, ReportSort, ReportType
responsive.zod.tsBreakpointColumnMap, BreakpointName, BreakpointOrderMap, ResponsiveConfig, ResponsiveStyles, StyleMap
sharing.zod.tsSharingConfig
theme.zod.tsBorderRadius, ColorPalette, Shadow, Theme, ThemeMode, Typography
view.zod.tsAddRecordConfig, AppearanceConfig, CalendarConfig, ColumnPrefix, ColumnSummary, ColumnSummaryConfig, FormButtonConfig, FormField, FormFieldPublicPicker, FormSection, FormView, GalleryConfig, GanttConfig, GanttQuickFilter, GroupingConfig, GroupingField, HttpMethodSubset, HttpRequest, KanbanConfig, ListChartConfig, ListColumn, ListView, NavigationConfig, NavigationMode, ObjectListView, ObjectUserFilters, PaginationConfig, RowColorConfig, RowHeight, SelectionConfig, TimelineConfig, TreeConfig, UserActionsConfig, UserFilterField, UserFilters, View, ViewData, ViewFilterRule, ViewItem, ViewItemName, ViewItemWire, ViewKind, ViewScope, ViewSharing, ViewTab, VisualizationType

Schema Conventions

Naming

  • Configuration keys (TypeScript props): camelCasemaxLength, referenceFilters
  • Machine names (data values): snake_casename: 'project_task', object: 'account'
  • Metadata type names: singular — 'view', 'flow', 'agent'

Validation

  • Every schema is a Zod schema; TypeScript types are inferred with z.infer<typeof Schema>
  • JSON Schemas are generated from the Zod sources, so IDE completion and the docs cannot drift apart

Usage

import { ObjectSchema } from '@objectstack/spec/data';

// Runtime validation
const result = ObjectSchema.safeParse(objectDefinition);

Each module is importable on its own subpath (@objectstack/spec/<module>); every reference page shows the exact import line for the schemas it documents.


Next Steps

On this page