This document serves as the Grand Map of the ObjectStack specification. It lists every protocol definition available in the system, categorized by domain.
Guidance for AI Agents:
- Primary Protocols (marked with ⭐) are the most frequently used definitions.
- Support Protocols provide internal structures or auxiliary types.
- Always check the file content for specific Zod schema definitions.
The "Database as Code" layer. Defines the shape, validation, and storage of data.
| File | Status | Description |
|---|---|---|
object.zod.ts |
⭐ | Object Definition. The core unit of data (tables), including fields, permissions, and event hooks. |
field.zod.ts |
⭐ | Field Types. Defines all supported data types (text, number, lookup, formula, etc.). |
query.zod.ts |
⭐ | ObjectQL. The JSON-based query language AST (filters, sorts, expands). |
validation.zod.ts |
⭐ | Validation Rules. Server-side data validation logic and error messages. |
datasource.zod.ts |
Datasource Config. Connection settings for external databases (Postgres, Mongo, etc.). | |
driver.zod.ts |
Driver Interface. Abstract base for database drivers. | |
driver-sql.zod.ts |
SQL Driver. Specific configurations for SQL-based drivers. | |
driver-nosql.zod.ts |
NoSQL Driver. Specific configurations for NoSQL drivers. | |
driver/mongo.zod.ts |
MongoDB Driver. MongoDB specific connection options. | |
driver/postgres.zod.ts |
PostgreSQL Driver. PostgreSQL specific connection options. | |
dataset.zod.ts |
Dataset. Virtual capabilities for analytics datasets. | |
analytics.zod.ts |
Data Analytics. Aggregation and multidimensional analysis types. | |
document.zod.ts |
Document. Unstructured document storage protocol. | |
external-lookup.zod.ts |
External Lookup. Virtual lookups to external API data. | |
filter.zod.ts |
Filter. Low-level filter syntax definitions. | |
hook.zod.ts |
Triggers/Hooks. Database trigger definitions (before/after insert/update). | |
mapping.zod.ts |
Data Mapping. Rules for transforming data between schemas. | |
data-engine.zod.ts |
Data Engine. Internal engine configuration. |
The "Frontend as Code" layer. Defines the user interface and interactions.
| File | Status | Description |
|---|---|---|
app.zod.ts |
⭐ | App Container. Defines the application shell, navigation menu, and branding. |
view.zod.ts |
⭐ | Views. List views (Grid, Kanban) and Record views (Form layouts). |
page.zod.ts |
⭐ | Custom Pages. Drag-and-drop page builder definitions. |
dashboard.zod.ts |
⭐ | Dashboards. Logic for grid-based analytic dashboards. |
report.zod.ts |
⭐ | Reports. Reporting definitions (tabular, summary, matrix). |
action.zod.ts |
⭐ | Actions. Buttons, links, and operations available on UI. |
chart.zod.ts |
Charts. Visualization configurations (Bar, Pie, Line, etc.). | |
widget.zod.ts |
Widgets. Reusable UI components for dashboards and pages. | |
component.zod.ts |
Components. Low-level component definitions. | |
theme.zod.ts |
Theming. Color palettes and visual styling rules. |
The "Logic as Code" layer. Defines business processes and orchestration.
| File | Status | Description |
|---|---|---|
workflow.zod.ts |
⭐ | Workflow Rules. Event-driven automation (if this then that). |
flow.zod.ts |
⭐ | Visual Flow. Complex orchestration logic (decisions, loops, CRUD). |
approval.zod.ts |
⭐ | Approval Process. Multi-step approval workflows. |
webhook.zod.ts |
⭐ | Webhooks. Outbound HTTP notification configuration. |
trigger-registry.zod.ts |
Trigger Registry. Central registry for all automation triggers. | |
etl.zod.ts |
ETL Jobs. Extract-Transform-Load definitions. | |
sync.zod.ts |
Data Sync. Bi-directional synchronization rules. |
The "Agent as Code" layer. Defines autonomous actors and cognitive pipelines.
| File | Status | Description |
|---|---|---|
agent.zod.ts |
⭐ | AI Agent. Attributes of an AI assistant (role, personality, model). |
agent-action.zod.ts |
⭐ | Tools & Actions. Capabilities exposed to the AI (Function Calling). |
mcp.zod.ts |
⭐ | Model Context Protocol (MCP). Standard protocol for connecting AI to tools, resources, and data sources. |
rag-pipeline.zod.ts |
⭐ | RAG. Retrieval Augmented Generation configurations. |
model-registry.zod.ts |
LLM Registry. Configuration for model providers (OpenAI, Anthropic). | |
conversation.zod.ts |
Chat Session. History and context management for AI chats. | |
nlq.zod.ts |
Natural Language Query. Definitions for text-to-SQL/Query logic. | |
orchestration.zod.ts |
Orchestration. Multi-agent coordination patterns. | |
feedback-loop.zod.ts |
RLHF. Feedback mechanisms for model improvement. | |
cost.zod.ts |
Cost Tracking. Token usage and billing metrics. | |
devops-agent.zod.ts |
DevOps Agent. Specialized agent for system operations. | |
plugin-development.zod.ts |
Plugin Dev. AI assistance for plugin creation. | |
predictive.zod.ts |
Predictive AI. Machine learning model configurations. | |
runtime-ops.zod.ts |
Runtime Ops. Operational parameters for AI runtime. |
The "Access as Code" layer. Defines users, organization, and permissions.
| File | Status | Description |
|---|---|---|
identity.zod.ts |
⭐ | User Identity. User accounts, authentication attributes. |
organization.zod.ts |
⭐ | Organization. Multi-tenancy structure (spaces, companies). |
permission.zod.ts |
⭐ | Permissions. ACLs for Objects, Fields, and Apps. |
role.zod.ts |
Roles. Hierarchical role definitions. | |
policy.zod.ts |
Security Policy. Global security settings and restrictions. | |
sharing.zod.ts |
Sharing Rules. Record-level access rules (sharing calculation). | |
rls.zod.ts |
Row Level Security. Database-level RLS definitions. | |
territory.zod.ts |
Territory Management. Sales territory models. | |
scim.zod.ts |
SCIM Protocol. Identity provisioning standards. |
The "Connectivity as Code" layer. Defines external connections.
| File | Status | Description |
|---|---|---|
connector.zod.ts |
⭐ | Connector Definition. Metadata for external API integrations (OpenAPI wrapper). |
connector/saas.zod.ts |
SaaS Connectors. Specifics for SaaS APIs (Salesforce, Stripe). | |
connector/database.zod.ts |
DB Connectors. External database integration. | |
connector/file-storage.zod.ts |
Storage Connectors. S3, Blob Storage integrations. | |
connector/message-queue.zod.ts |
MQ Connectors. Kafka, RabbitMQ integrations. | |
connector/github.zod.ts |
GitHub Connector. Logic for Git integration. | |
connector/vercel.zod.ts |
Vercel Connector. Deployment integration. |
The "Infrastructure as Code" layer. Defines runtime behaviors.
| File | Status | Description |
|---|---|---|
job.zod.ts |
⭐ | Background Jobs. Cron and scheduled task definitions. |
auth-config.zod.ts |
Auth Configuration. SSO, OIDC, SAML settings. | |
http-server.zod.ts |
HTTP Server. Server port, CORS, and middleware settings. | |
logging.zod.ts |
Logging. Log levels and output formats. | |
audit.zod.ts |
Audit Trail. Audit logging configuration. | |
cache.zod.ts |
Caching. Redis/Memory cache strategies. | |
metrics.zod.ts |
Observability. Prometheus/OpenTelemetry metrics. | |
tracing.zod.ts |
Tracing. Distributed tracing configuration. | |
object-storage.zod.ts |
File Storage. S3 bucket and upload configurations. | |
message-queue.zod.ts |
Message Queue. Internal event bus settings. | |
search-engine.zod.ts |
Search. Elasticsearch/Meilisearch configuration. | |
notification.zod.ts |
Notifications. System-wide notification preferences. | |
translation.zod.ts |
i18n. Internationalization and localization. | |
worker.zod.ts |
Worker Nodes. Background worker scaling config. | |
compliance.zod.ts |
Compliance. GDPR/SOC2 policies. | |
encryption.zod.ts |
Encryption. At-rest and in-transit encryption keys. | |
masking.zod.ts |
Data Masking. PII data masking rules. | |
migration.zod.ts |
Migration. Database schema migration tracking. | |
change-management.zod.ts |
Change Mgmt. Deployment history and rollbacks. | |
collaboration.zod.ts |
Collaboration. Real-time collaboration settings. |
The "Interface as Code" layer. Defines the external API surface.
| File | Status | Description |
|---|---|---|
protocol.zod.ts |
⭐ | Stack Protocol. valid requests and responses for the platform. |
dispatcher.zod.ts |
⭐ | HttpDispatcher. Route-to-service mapping for API routing. |
discovery.zod.ts |
⭐ | Service Discovery. Service registration and API routes discovery. |
endpoint.zod.ts |
API Endpoints. REST API route definitions. | |
graphql.zod.ts |
GraphQL. Schema and resolver configuration. | |
rest-server.zod.ts |
REST Server. REST-specific server settings. | |
auth.zod.ts |
API Auth. Authentication schemes for APIs. | |
analytics.zod.ts |
API Analytics. Usage tracking for APIs. | |
documentation.zod.ts |
Docs. OpenAPI/Swagger generation config. | |
realtime.zod.ts |
Realtime. WebSocket/SSE configurations. | |
websocket.zod.ts |
WebSockets. Low-level text/binary socket frames. | |
router.zod.ts |
Routing. API Gateway routing rules. | |
http-cache.zod.ts |
HTTP Cache. Cache-Control headers and CDNs. | |
errors.zod.ts |
Error Handling. Standard error response formats. | |
metadata.zod.ts |
Metadata API. Endpoints for schema retrieval. | |
odata.zod.ts |
OData. OData protocol support. | |
batch.zod.ts |
Batch API. Bulk request processing. | |
contract.zod.ts |
API Contracts. Versioned API signatures. | |
storage.zod.ts |
Storage API. File upload/download endpoints. | |
hub.zod.ts |
Hub API. Main Hub communication protocol. | |
registry.zod.ts |
Registry API. Package registry interface. |
The "Marketplace as Code" layer. Defines the package ecosystem.
| File | Status | Description |
|---|---|---|
registry-config.zod.ts |
⭐ | Registry Config. Configuration for the package registry. |
plugin-registry.zod.ts |
Plugin Registry. Metadata for available plugins. | |
marketplace.zod.ts |
Marketplace. Listings, pricing, and vendor info. | |
tenant.zod.ts |
Tenant. Multi-tenant environment isolation. | |
license.zod.ts |
Licensing. License keys and entitlements. | |
composer.zod.ts |
Composer. Package dependency resolution. | |
space.zod.ts |
Space. Collaborative workspaces. | |
hub-federation.zod.ts |
Federation. Cross-instance hub communication. | |
plugin-security.zod.ts |
Plugin Security. Security verification for plugins. |
The "OS as Code" layer. Defines low-level plugin lifecycles.
| File | Status | Description |
|---|---|---|
plugin.zod.ts |
⭐ | Plugin Definition. The structure of an ObjectStack plugin. |
manifest.zod.ts |
⭐ | Manifest. The package.json equivalent for the stack. |
context.zod.ts |
Execution Context. Request-scoped context (user, transaction). | |
events.zod.ts |
Kernel Events. System lifecycle events. | |
feature.zod.ts |
Feature Flags. Toggleable system features. | |
service-registry.zod.ts |
Service Registry. Internal dependency injection. | |
metadata-loader.zod.ts |
Loader. Logic for loading definitions from disk/DB. | |
plugin-loading.zod.ts |
⭐ | Plugin Loading. Loading strategies, production-safe hot reload (environment, productionSafety), full plugin sandboxing (scope, ipc), code splitting, caching, and performance monitoring. |
plugin-runtime.zod.ts |
⭐ | Dynamic Loading. Runtime load/unload of plugins (DynamicLoadRequest, DynamicUnloadRequest), activation events, plugin discovery from registries/directories, and source resolution (npm/local/url/registry/git). |
plugin-versioning.zod.ts |
Versioning. Semantic versioning rules for plugins. | |
plugin-validator.zod.ts |
Validation. Integrity checks for plugins. | |
plugin-structure.zod.ts |
Structure. Zod rules for folder layout and file naming. | |
plugin-capability.zod.ts |
Capabilities. What a plugin can do. | |
plugin-lifecycle-events.zod.ts |
Lifecycle Events. Hooks for plugin state changes. | |
plugin-lifecycle-advanced.zod.ts |
Advanced Lifecycle. Health monitoring, hot reload state management, graceful degradation, and update strategies. | |
plugin-security-advanced.zod.ts |
Advanced Security. Permission system, sandbox configuration (V8/WASM/container/process), security scanning, and trust levels. | |
startup-orchestrator.zod.ts |
Startup. Boot sequence orchestration. |