Skip to main content

Documentation Index

Fetch the complete documentation index at: https://koreai-v2-home-nav.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Last Updated: 2026-03-16 Implementation Score: 87/100 — Core features implemented. Validation and production deployment TBD.
Status Legend:
  • Implementation: Code complete, unit/integration tested in dev
  • Validation: Load testing, security audit, penetration testing — TBD
  • Deployment: Production deployment, configuration, monitoring setup — TBD

Executive Summary

CategoryImplementationValidationDeploymentScore
Authentication & AuthorizationImplementedTBDTBD9/10
Multi-Tenancy & IsolationImplementedTBDTBD10/10
Data Security & EncryptionImplementedTBDTBD10/10
GDPR & ComplianceImplementedTBDTBD9/10
Audit & LoggingImplementedTBDTBD9/10
Observability & MonitoringImplementedTBDTBD8/10
ScalabilityImplementedTBDTBD10/10
Deployment & InfrastructureImplementedTBDTBD9/10
Agent Development & CollaborationImplementedTBDTBD9/10
Testing & QualityImplementedTBDTBD8/10
API & IntegrationImplementedTBDTBD9/10
Backup & ArchivalPartialTBDTBD5/10
PerformanceImplementedTBDTBD9/10
Disaster RecoveryGapTBDTBD3/10
Rate Limiting & ThrottlingImplementedTBDTBD10/10

1. Authentication & Authorization

Implementation: Complete | Validation: TBD | Deployment: TBD (9/10)

Implemented

FeatureImplementationFiles
Unified Auth MiddlewareCentral dispatcher: User JWT, SDK Token, API Keypackages/shared-auth/src/middleware/unified-auth.ts
RBAC SystemGranular object:operation permissionsapps/runtime/src/middleware/rbac.ts
Permission GuardsrequirePermission(), requireAllPermissions(), requireAnyPermission(), requireProjectScope(), requireEnvironmentScope()packages/shared-auth/src/middleware/permission-guard.ts
Project-Level RBACBuilt-in admin, developer, tester, viewer project roles plus custom role resolutionpackages/shared-auth/src/rbac/role-permissions.ts, apps/runtime/src/middleware/rbac.ts
IP AllowlistingCIDR + plain IP matching for admin routespackages/shared-auth/src/middleware/
MFA FrameworkJWT payload detection for mfa_pendingpackages/shared-auth/src/middleware/unified-auth.ts
Enterprise Auth SchemesSAML 2.0, Kerberos, WS-Security, Hawk, Digest (with tests)packages/auth-enterprise/src/
OIDC/OAuth2OAuth2 client adapter, OIDC supportpackages/auth-enterprise/src/, packages/agent-transfer/src/adapters/auth/oidc.ts
API Key ManagementScoped API keys (abl_* prefix), project + environment bindingpackages/shared-auth/src/middleware/unified-auth.ts

Gaps

GapImpact
MFA full implementationMedium — framework exists, TOTP/SMS not wired
Session token revocation APILow — tokens are short-lived
Certificate pinning for external authLow

2. Multi-Tenancy & Isolation

Implementation: Complete | Validation: TBD | Deployment: TBD (10/10)

Implemented

FeatureImplementationFiles
Automatic Tenant IsolationAsyncLocalStorage-based tenantId injection on all DB queriespackages/database/src/mongo/plugins/tenant-isolation.plugin.ts
Tenant Context PropagationRequest-scoped tenant context bridgepackages/shared-auth/src/middleware/tenant-context.ts
Cross-Tenant GuardReturns 404 (not 403) to prevent tenant enumerationAll repo functions
Tenant-Scoped ResourcesAll models include tenantId indexingpackages/database/src/models/
Tenant ConfigurationPer-tenant KMS, crawl policy, LLM policy, member rolespackages/database/src/models/
SuperAdmin ContextExplicit bypass for platform admins onlypackages/database/src/mongo/
Per-Tenant Rate LimitsPlan-aware limits (FREE, TEAM, BUSINESS, ENTERPRISE)apps/runtime/src/middleware/rate-limiter.ts

Gaps

None identified.

3. Data Security & Encryption

Implementation: Complete | Validation: TBD | Deployment: TBD (10/10)

Implemented

FeatureImplementationFiles
AES-256-GCM EncryptionField-level encryption at rest with per-document keyspackages/database/src/mongo/plugins/encryption.plugin.ts
Tenant Secret EncryptionDEK envelope with provider-tracked KEK wrappingpackages/database/src/mongo/plugins/encryption.plugin.ts
KMS Provider PoolAWS KMS, GCP Cloud KMS, Azure Key Vault, External KMS, Local fallbackpackages/database/src/kms/kms-provider-pool.ts
Master Key Management64-char hex (32-byte) with validationpackages/database/src/mongo/
ClickHouse EncryptionAnalytics data encrypted before storagepackages/database/src/clickhouse-encryption-interceptor.ts
Session Field EncryptionEncrypted transfer session statepackages/agent-transfer/src/security/session-field-encryption.ts
Webhook Signature VerificationHMAC-based authenticitypackages/shared-kernel/src/security/webhook-signature.ts
PII DetectionBuilt-in PII detector for guardrailspackages/compiler/src/security/pii-detector.ts
Payload Size ValidationEnforced at API boundariesMiddleware layer

Gaps

GapImpact
Automated key rotation schedulingMedium — manual rotation works

4. GDPR & Compliance

Implementation: Complete | Validation: TBD | Deployment: TBD (9/10)

Implemented

FeatureImplementationFiles
Right to ErasureCascade deletion (Messages → Sessions → Agents → Projects)packages/database/src/cascade/cascade-delete.ts
GDPR ServiceDelegation to EventLifecycle for session/tenant deletionpackages/eventstore/src/retention/event-gdpr-service.ts
Audit Log AnonymizationAudit logs NEVER deleted; users anonymized (userId, email, IP, userAgent)packages/database/src/cascade/
PII Audit TrailDedicated audit log for PII operationspackages/database/src/models/pii-audit-log.model.ts
Retention PoliciesTTL-based event cleanuppackages/eventstore/src/retention/event-retention-service.ts
Per-Tenant RetentionConfigurable message retention per planapps/runtime/src/services/tenant-config.ts
Data ExportProject-level import/exportpackages/project-io/
Trace ScrubbingRemoves sensitive data from execution tracespackages/compiler/src/platform/constructs/executors/trace-scrubber.ts
Message ScrubbingGDPR right-to-erasure for messages by contact/sessionapps/runtime/src/services/stores/mongo-message-store.ts

Gaps

GapImpact
Data Subject Access Request (DSAR) endpointMedium — export exists but no self-service DSAR API
Consent management modelLow — platform is B2B, not direct consumer
Data processing agreements (DPA) templateLow — documentation only

5. Audit & Logging

Implementation: Complete | Validation: TBD | Deployment: TBD (9/10)

Implemented

FeatureImplementationFiles
Audit Trail PluginAuto-tracks create/update/delete with actor contextpackages/database/src/mongo/plugins/audit-trail.plugin.ts
Actor ContextuserId, email, IP, userAgent via AsyncLocalStoragepackages/database/src/mongo/plugins/audit-trail.plugin.ts
Trace EventsStructured schema for execution tracingpackages/observatory/src/schema/trace-events.ts
Centralized LoggercreateLogger() factory with pinopackages/shared-observability/src/logger.ts
Observatory UIReal-time trace inspection in Studioapps/studio/src/components/observatory/
PII Audit LogDedicated tracking for PII-sensitive operationspackages/database/src/models/pii-audit-log.model.ts
Admin AuditAdmin dashboard access and action loggingapps/admin/src/lib/audit-logger.ts

Gaps

GapImpact
SIEM/syslog integrationMedium — needed for SOC2 compliance
Log retention policy automationLow — manual cleanup works

6. Observability & Monitoring

Implementation: Complete | Validation: TBD | Deployment: TBD (8/10) Stack: Coroot (current) + Groundcover (production add-on). eBPF-based, zero-instrumentation.

Implemented

FeatureImplementationFiles
Health ChecksPer-service /health endpointsAll apps routes/health.ts
Circuit BreakerRedis-backed distributed CB (CLOSED → OPEN → HALF_OPEN)packages/circuit-breaker/src/redis-circuit-breaker.ts
Circuit Breaker RegistryMulti-breaker orchestration per tenant + connectorpackages/circuit-breaker/src/registry.ts
Internal TraceStoreSession-level execution tracingpackages/compiler/src/platform/stores/trace-store.ts
Observatory DashboardReal-time span tree, event timeline, flow visualizationapps/studio/src/components/observatory/
Request InstrumentationMiddleware for request/response metricspackages/shared-observability/src/middleware/observability.ts
Structured Loggingpino-based JSON logging with correlationpackages/shared-observability/src/logger.ts
CorooteBPF-based service map, latency, error rate, dependency healthInfrastructure (Kubernetes sidecar)
Groundcover (production)Full eBPF APM — distributed tracing, metrics, logs, network analysisInfrastructure (DaemonSet, zero-code)

Production Observability Stack

LayerToolCoverage
Service Maps & DependenciesCorootAuto-discovered via eBPF
Distributed TracingGroundcovereBPF-captured, no SDK instrumentation needed
Metrics & AlertingCoroot + GroundcoverLatency, error rate, throughput per service
Log AggregationGroundcoverCorrelated with traces and metrics
Network AnalysisGroundcoverDNS, TCP retransmits, connection issues
Application-Level TracesInternal TraceStore + ObservatoryAgent execution spans, LLM calls, tool calls

Gaps

GapImpact
Custom Grafana dashboards for ABL KPIsLow — Coroot/Groundcover dashboards cover infra
OTEL SDK instrumentation (optional)Low — eBPF covers network/service level already
Agent-level cost/token alerting rulesMedium — data exists in TraceStore, no alerts

7. Scalability

Implementation: Complete | Validation: TBD | Deployment: TBD (10/10)

Implemented

FeatureImplementationFiles
Redis State ManagementSession, cache, pub/sub, distributed lockspackages/redis/src/
BullMQ Job QueuesAsync processing for heavy workloadspackages/redis/src/bullmq.ts
Distributed LocksRedis SET NX PX with retry and auto-releasepackages/shared-observability/src/distributed-lock.ts
Stateless ArchitectureAll shared state in Redis/MongoDB, no pod-local truthArchitecture principle
Connection PoolingMongoDB (Mongoose), Redis (ioredis)Config layer
Horizontal ScalingNo sticky sessions requiredArchitecture principle
Sliding Window Rate LimitingPer-tenant with Redis + in-memory fallbackapps/runtime/src/middleware/rate-limiter.ts
Kafka IntegrationEvent streaming for SearchAI pipelineapps/search-ai/src/
ClickHouse AnalyticsColumnar store for high-volume trace/metrics datapackages/database/src/clickhouse.ts

Gaps

None identified.

8. Deployment & Infrastructure

Implementation: Complete | Validation: TBD | Deployment: TBD (9/10)

Implemented

FeatureImplementationFiles
Docker ComposeComplete dev stack (MongoDB, Redis, ClickHouse, Kafka)docker-compose.yml
Production DockerfilesMulti-stage builds for all appsapps/*/Dockerfile
Harness CI/CDBuild pipeline with tests.harness/pipelines/ci-build.yaml
Release ManagementCalVer versioning, apx release CLIscripts/release.ts, apx
Three-Repo ArchitectureSource, Deploy (Helm/ArgoCD), Infra (Terraform)Architectural design
K8s Load TestingK6 operator manifestsdeploy/k8s/benchmarks/k6-operator.yaml
Environment ValidationRuntime config schema validationpackages/config/src/schemas/
PM2 Process ManagementLocal multi-service orchestrationecosystem.config.js

Gaps

GapImpact
Harness release pipeline (release/* branches)Medium — manual release process works
Blue/green or canary deploymentsLow — not needed for initial launch

9. Agent Development & Collaboration

Implementation: Complete | Validation: TBD | Deployment: TBD (9/10)

Implemented

FeatureImplementationFiles
Project-Level RBACadmin, developer, tester, viewer, and custom rolespackages/shared-auth/src/rbac/role-permissions.ts, apps/runtime/src/middleware/rbac.ts
Agent VersioningVersion tracking in project structurepackages/compiler/src/
Import/ExportV2 layered import with cross-reference resolutionpackages/project-io/
Git IntegrationWebhook sync, Bitbucket/GitHub/GitLab providerspackages/project-io/src/git/
Workspace ManagementTenant-level project organizationpackages/database/src/models/
ABL DSLDomain-specific language for agent definitionspackages/core/, packages/compiler/
Studio IDEVisual editor with Monaco, observatory, architectapps/studio/
Template SystemAgent templates, evaluation rubricspackages/database/src/templates/
Collaboration RolesTenantMember, ProjectMember with role-based accesspackages/shared-auth/
MCP Server SupportExternal tool integration via Model Context Protocolpackages/shared/src/services/mcp-server-registry.ts

Gaps

GapImpact
Real-time collaborative editingLow — single editor workflow sufficient initially
Change notifications/presenceLow — no concurrent editing currently
Agent marketplace/sharingLow — future feature

10. Testing & Quality

Implementation: Complete | Validation: TBD | Deployment: TBD (8/10)

Implemented

FeatureImplementationFiles
Unit Test FrameworkVitest across 44+ packages*/vitest.config.ts
Fast Test Tiertest:fast for CI (threads/forks pool)*/vitest.unit.config.ts
Integration TestsMulti-package integration suites*/__tests__/
E2E TestsAgent transfer, compiler, runtime flows*/__tests__/e2e/
Load TestingK6 operator for Kubernetesdeploy/k8s/benchmarks/
Pre-Commit HooksPrettier, TypeScript type-checking, gitleaks.husky/, .claude/hooks/
Pre-Push TestsAffected package testing via turbo.husky/pre-push
CommitlintEnforced [ABLP-123] type(scope): descriptioncommitlint.config.ts

Gaps

GapImpact
Minimum coverage targets per packageMedium — no enforced thresholds
Browser/visual regression testingLow — Playwright present but not in CI
Chaos engineering/fault injectionLow — circuit breakers tested in isolation

11. API & Integration

Implementation: Complete | Validation: TBD | Deployment: TBD (9/10)

Implemented

FeatureImplementationFiles
OpenAPI DocumentationAuto-generated from route handlerspackages/openapi/
Webhook SystemEvent forwarding with delivery tracking and retrypackages/eventstore/src/webhook/
A2A ProtocolAgent-to-agent communication with auth + SSRF protectionpackages/a2a/
MCP SupportModel Context Protocol for external toolspackages/shared/src/services/mcp-server-registry.ts
Rate LimitingPer-tenant, per-operation with plan awarenessapps/runtime/src/middleware/rate-limiter.ts
CORSConfigurable originspackages/config/src/schemas/cors.schema.ts
SDKWeb SDK for agent embeddingpackages/web-sdk/
Connector SDKExtensible connector framework (25+ connectors)packages/connectors/
Channel SystemWhatsApp, Twilio SMS, Voice, HTTP async, email, Slackapps/runtime/src/routes/channel-webhooks.ts

Gaps

GapImpact
GraphQL APILow — REST is sufficient
API versioning (v1/v2)Low — single version currently

12. Backup & Archival

Implementation: Partial | Validation: TBD | Deployment: TBD (5/10)

Implemented

FeatureImplementationFiles
Archive FrameworkConfig schema and manifest modelpackages/config/src/schemas/archive.schema.ts
TTL IndexesAutomatic cleanup on session collectionsMongoDB TTL indexes
Retention ServiceEventStore TTL-based cleanuppackages/eventstore/src/retention/
Data ExportProject-level export for manual backupspackages/project-io/
Per-Tenant RetentionConfigurable message retention by plan tierapps/runtime/src/services/tenant-config.ts

Gaps

GapImpact
S3/cloud storage backendHIGH — no offsite backup
Automated backup scheduleHIGH — manual only
Incremental backupMedium
Backup integrity validation
Point-in-time recovery (PITR)Medium — MongoDB supports it, not configured
Cross-region replicationMedium

13. Performance

Implementation: Complete | Validation: TBD | Deployment: TBD (9/10)

Implemented

FeatureImplementationFiles
Async Gzip CompressionCompress before storingpackages/pipeline-engine/src/pipeline/services/eval/eval-compression.ts
Tenant Key CacheLRU with TTL evictionpackages/shared/src/encryption/cache/tenant-key-cache.ts
Conversation Sliding WindowLightweight message window readspackages/pipeline-engine/src/pipeline/services/read-message-window.service.ts
Batch OperationsBullMQ for async job batchingpackages/redis/src/bullmq.ts
Database IndexingCompound indexes on tenantId + timestampsAll models
MongoDB CompressionSnappy/Zstd compressorsConnection config
Payload Size ValidationEnforced at API boundariesMiddleware
Connection PoolingMongoose + ioredis poolsConfig layer

Gaps

GapImpact
Query plan monitoring/slow query alertsLow — slow query logging exists
CDN for static assetsLow — Next.js handles

14. Disaster Recovery

Implementation: Partial | Validation: TBD | Deployment: TBD (3/10)

Implemented

FeatureImplementationFiles
MongoDB Replica SetSingle-node replica set (dev) with keyfile authdocker-compose.yml
Redis PersistenceVolume-backed data persistencedocker-compose.yml
Distributed LocksPrevents duplicate execution during failoverpackages/shared-observability/src/distributed-lock.ts
Event SourcingEventStore as recovery source of truthpackages/eventstore/src/

Gaps

GapImpact
Multi-region MongoDB replicationCRITICAL — single point of failure
Automated failover scriptsHIGH — manual intervention required
Scheduled database backupsHIGH — no automated backup
RPO/RTO documentationHIGH — not defined
Disaster recovery runbookHIGH — no runbook
Cross-AZ Redis (Sentinel/Cluster)
ClickHouse replicationMedium — ReplicatedMergeTree ready but not configured

15. Rate Limiting & Throttling

Implementation: Complete | Validation: TBD | Deployment: TBD (10/10)

Implemented

FeatureImplementationFiles
Per-Tenant Sliding WindowRequests/min, tokens/min, concurrent sessions, tool calls/minapps/runtime/src/middleware/rate-limiter.ts
Plan-Aware LimitsFREE/TEAM/BUSINESS/ENTERPRISE tiersapps/runtime/src/services/tenant-config.ts
Hybrid Rate LimiterRedis primary + in-memory fallbackapps/runtime/src/middleware/rate-limiter.ts
SearchAI Rate LimitingFixed-window with Redis fallback (120 req/min)apps/search-ai/src/middleware/rate-limit.ts
Connector Rate LimitingExternal API backoff strategiespackages/connectors/base/src/client/rate-limiter.ts
Eval Rate LimitingEvaluation-specific throttlingpackages/pipeline-engine/src/pipeline/services/eval/eval-rate-limiter.ts
Agent Transfer ThrottleSession-level rate limitingpackages/agent-transfer/src/security/rate-limiter.ts
Circuit BreakerDistributed CB as fallback when limits exceededpackages/circuit-breaker/src/

Gaps

None identified.

Enterprise Readiness Backlog

#PriorityCategoryItemDescription
1P0BackupAutomated database backupsMongoDB, Redis, and ClickHouse have no scheduled backup automation. A single disk failure or accidental deletion would result in permanent data loss. Needs cron-based mongodump/redis-cli BGSAVE with S3 upload and retention policy.
2P0Disaster RecoveryRPO/RTO documentation + DR runbookRecovery Point Objective and Recovery Time Objective are not defined. Enterprise audits (SOC2, ISO 27001) require documented recovery targets and a step-by-step runbook for failover scenarios.
3P0Disaster RecoveryMulti-region database replicationMongoDB runs as a single-node replica set. A region outage takes down the entire platform with no automatic failover. Needs Atlas or self-managed multi-AZ replica set with automatic primary election.
4P0AuditSIEM integration (syslog/Splunk)Audit logs and structured pino output are only stored locally. SOC2 compliance requires centralized log aggregation with tamper-proof retention. Needs syslog exporter or Splunk/Elastic forwarder from pino transport.
5P1BackupS3/cloud storage for backupsThe archive framework exists (packages/config/src/schemas/archive.schema.ts) but no S3 backend is wired. Backups must be stored offsite in a different availability zone. Needs AWS S3 or GCS client integration in the archive store.
6P1ObservabilityAgent-level cost and token alertingLLM cost and token usage data is captured in TraceStore and ClickHouse but no alerting rules exist. A runaway agent could burn through API credits without anyone being notified. Needs threshold-based alerts on per-tenant token spend with PagerDuty/Slack integration.
7P1AuthMFA full implementationThe MFA framework exists in the JWT payload (mfa_pending type detection) but TOTP and SMS verification are not wired. Enterprise customers expect MFA enforcement for admin and developer accounts. Needs TOTP generation, QR code enrollment, and verification middleware.
8P1GDPRDSAR self-service endpointRight-to-erasure (deletion) is fully implemented, but Data Subject Access Requests (export of all personal data) require manual intervention. GDPR Article 15 mandates a machine-readable export. Needs a /api/v1/gdpr/dsar endpoint that bundles all user data into a downloadable archive.
9P1SecurityKMS key rotation automationKey rotation works manually via the KMS provider pool, but there is no scheduled automatic rotation. NIST 800-57 recommends annual rotation at minimum. Needs a cron job or BullMQ scheduled task that rotates tenant CEKs and re-encrypts affected documents.
10P1PerformanceK6 load testing benchmarksK6 operator manifests exist (deploy/k8s/benchmarks/k6-operator.yaml) but no benchmark suite has been executed. Baseline performance numbers (p50/p95/p99 latency, max throughput, concurrent session limits) are unknown. Needs test scenarios for chat API, WebSocket connections, and SearchAI queries run against a staging cluster.
11P2ObservabilityCustom Grafana dashboards for ABL KPIsCoroot and Groundcover provide infrastructure-level dashboards but no agent-specific views. Teams need dashboards showing agent success rates, handoff frequency, average conversation length, and LLM cost per agent. Needs Grafana dashboards backed by ClickHouse queries on TraceStore data.
12P2TestingChaos engineering and fault injectionCircuit breakers and distributed locks are unit-tested but never validated under real failure conditions. Needs Chaos Mesh or Litmus experiments for pod kills, network partitions, Redis failover, and MongoDB primary stepdown.
13P2DeploymentBlue/green or canary deploymentsReleases currently deploy all pods simultaneously. A bad release affects all users instantly with no rollback window. Needs ArgoCD progressive delivery with Argo Rollouts or Flagger for canary traffic shifting.
14P2Disaster RecoveryCross-AZ Redis (Sentinel/Cluster)Redis runs as a single instance. A Redis failure disables rate limiting, distributed locks, BullMQ queues, and circuit breaker state. Needs Redis Sentinel for automatic failover or Redis Cluster for horizontal sharding.
15P2Disaster RecoveryClickHouse replicationClickHouse uses MergeTree engine. The ReplicatedMergeTree engine is ready in the schema (packages/pipeline-engine/src/pipeline/schemas/init-eval-tables.ts) but not enabled. Analytics data would be lost in a disk failure. Needs ZooKeeper/ClickHouse Keeper and ReplicatedMergeTree activation.
16P3CollaborationReal-time collaborative editingOnly one user can edit an agent at a time. Concurrent edits result in last-write-wins. Enterprise teams with multiple developers need CRDT-based or OT-based real-time collaboration in the Studio editor, similar to Google Docs or Figma.
17P3APIGraphQL APIThe platform exposes REST APIs only. Some enterprise integrations and frontend use cases benefit from GraphQL’s flexibility for partial field selection and batched queries. Needs a GraphQL gateway layer over the existing REST endpoints.
18P3ObservabilityOTEL SDK instrumentationGroundcover captures network-level traces via eBPF, but application-internal spans (e.g., LLM prompt construction, tool parameter resolution) are only in the internal TraceStore. Optional OTEL SDK instrumentation would bridge internal spans into the Groundcover/Jaeger timeline for end-to-end correlation.