The Framework
An open-source, Java-based engine that interprets capability specs and runs them as live services. Apache 2.0 licensed, Docker-ready, community-driven.
Engine
A Java-based runtime packaged as a Docker image that interprets the capability YAML spec and runs it as a live service.
Java 21 LTS
Apache 2.0 licensed codebase with Maven artifacts on Maven Central and Javadocs on javadoc.io.
Docker runtime
Published Docker image on Docker Hub. One container per capability, Docker Compose for multi-capability fleets.
Hot-reload
Capability configuration reloads without container restart.
CLI
A command-line interface for local development, validation, and remote management of capabilities.
Validate
Validate YAML specs against JSON Schema and governance policies locally before commit.
Run
Launch capabilities as Docker containers with one command.
Control
Remote control of capabilities via the Control API -- start, stop, restart, status.
Skills
Download and install Agent Skills folders for developer agents.
Consumption & integration
Declarative HTTP client adapters that consume any public, private, or third-party API.
HTTP/REST
Forward any HTTP call, reuse templatized requests, or abstract into clean API operations through progressive abstraction levels.
Format conversion
Automatic conversion of JSON, XML, Avro, Protobuf, CSV, and YAML into a uniform JSON data model.
Authentication
Bearer, Basic, API key, and Digest authentication configured declaratively.
Reusable adapters
Shared HTTP adapter blocks declared once and referenced across multiple capabilities.
Protocol-neutral exposure
The same capability can be exposed simultaneously across multiple protocols from a single deployment.
REST API
Expose capability functions as a clean REST API with per-operation path, method, and parameter mapping.
MCP Server
Tools, resources, and prompts for AI copilots and agents. Streamable HTTP and stdio transports.
Agent Skills
Downloadable skill folders for developer agents with SKILL.md prompt integration.
A2A
Roadmap
Google's Agent-to-Agent protocol for cross-agent tool discovery and execution.
Orchestration
Chain multiple API calls, extract and map data between steps, and compose capabilities from other capabilities.
Multi-step workflows
Sequential call chains with data passing between steps via JSONPath output extraction.
Lookup steps
Cross-reference matching for enrichment and data joining across API responses.
Capability composition
Applied capabilities that consume source capabilities for domain-driven abstraction layers.
Conditional and parallel steps
Roadmap
Conditional execution, for-each iteration, and parallel-join for concurrent orchestration.
Resilience
Protect upstream APIs and control execution with built-in resilience patterns.
Circuit breaker
Sliding window error rate tracking with configurable thresholds and gradual recovery.
Retry
Configurable retry count with exponential, fixed, or custom back-off strategies.
Bulkhead
Concurrent call limits preventing a single slow dependency from exhausting threads.
Rate limiter
Token bucket rate limiting respecting upstream rate limits.
Observability
Built-in health, metrics, and structured logging for every capability.
/health
Liveness and readiness probes for Kubernetes container orchestration.
/metrics
Prometheus-compatible endpoint with request count, latency, error rates, and circuit breaker state.
Structured logs
JSON-formatted output with capability, namespace, operation, status code, and duration in every entry.
Deployment
From local Docker to production Kubernetes with GitOps and admission enforcement.
Docker / Compose
One container per capability. Docker Compose for multi-capability fleets.
Kubernetes
Deployments, Services, Ingress, ExternalSecrets with a NaftikoCapability CRD.
GitOps
ArgoCD/Flux reconciliation driven by the NaftikoCapability operator.
Admission enforcement
Kyverno ClusterPolicies mirror governance rules for deployment-time enforcement.
Get started
The alpha of the framework is open source and ready to use.
