kapsel 0.1.0-alpha.1

Crash-recoverable gateway for one authorized Kubernetes Deployment image operation
Documentation

kapsel

A crash-recoverable effect-gateway experiment for autonomous agents.

Kapsel is testing whether agents can use bounded operations instead of receiving unrestricted provider credentials. It verifies an owner-signed exact grant, records either a pre-attempt target rejection or the validated target before the dangerous mutation seam, recovers without blindly repeating the mutation, observes the receiver, and emits an inspectable result—including UNKNOWN when reality cannot be established. The remaining release work includes evaluator commands, MCP composition, a release-owned process-kill demo, and versioned distribution artifacts.

bounded agent intent
  -> owner-signed exact grant under application-configured trust
  -> durable pre-attempt rejection or target identity
  -> conditional provider mutation when attempted
  -> receiver observation or UNKNOWN
  -> classifier-complete signed experiment receipt

[!WARNING]

Kapsel is a pre-release experiment. It is not production-ready, a generic agent runtime, or a compliance product. Do not use it for consequential production changes.

Active experiment

The only active capability is:

kubernetes.set_deployment_image(namespace, deployment, container, immutable_image_digest)

The experiment runs against a disposable local kind cluster. Its live gate covers both a healthy rollout and an unavailable-image ProgressDeadlineExceeded rollout after a fault-injected post-patch reopen. Deterministic tests kill a separate gateway process at the mutation and receipt publication seams. Recovery reconciles receiver state without a blind second mutation and publishes only durably frozen receipt bytes.

The Rust Application interface separates request-only AgentRequest from operator-owned grant, trust, Kubernetes authority, signing material, and paths. It is available as a pre-V1 alpha for Rust evaluation. There is no supported public command yet.

Kapsel reports SUCCEEDED, FAILED, or UNKNOWN. These are bounded receiver outcomes, not claims of exactly-once mutation, causation, complete cluster health, complete capture, or Kubernetes truth.

Rust alpha

The crates.io alpha exposes the implemented fixed Kubernetes experiment and offline inspector:

[dependencies]
kapsel = "=0.1.0-alpha.1"

Operator composition constructs OperatorConfiguration, including the exact signed grant, external trust, Kubernetes client, receipt signing material, journal path, and private receipt directory. A request-only caller can then use Application::execute; restart recovery uses Application::reconcile, and adapters consume the resulting OperationReport without sequencing internal durable states.

This Unix-only alpha does not provide a CLI, configuration-file format, stable Rust API, stable receipt format, or production-readiness guarantee. See the experiment boundary before use.

What exists today

Surface Status
Signed exact grant and SQLite recovery lifecycle Implemented in the product package
Conditional Deployment image mutation Implemented and exercised by an explicit live-kind gate
Classifier-complete receipt and inspection Implemented in the experiment library
Process-kill mutation and publication recovery Implemented in deterministic subprocess tests
Failed-rollout live-kind test proof Implemented in the explicit live-kind gate
Evaluator demo with real process termination Not implemented
Evaluator-facing operation and inspection CLI Not implemented
MCP-compatible entrypoint Not implemented
V1 evaluator artifacts and checksums Not implemented

There is no quickstart yet because there is no supported public command. The current engineering proof is:

./scripts/ci-local.sh
./scripts/test-kind-effect-gateway.sh  # requires Docker and kind 0.32+

The live gate creates and removes its own uniquely named cluster. It is demonstration evidence, not part of the deterministic default gate. See Build for exact meaning and prerequisites.

Scope discipline

The repository has one capability and one Kubernetes adapter. Arbitrary execution, runtime plugins, a generic provider SDK, a policy language, hosted operation, a dashboard, and a second capability are outside its technical scope.

Read next

License

Licensed under the Apache License, Version 2.0.