Skip to content

Latest commit

Β 

History

History
44 lines (35 loc) Β· 2.59 KB

README.md

File metadata and controls

44 lines (35 loc) Β· 2.59 KB

infra β€” OpenCrane server runtime seams

OpenCrane β€Ί backend β€Ί server β€Ί infra

These libraries provide the OpenCrane API process with transport and external-I/O seams. They keep HTTP, OIDC, Kubernetes identity, and remote-service mechanics outside durable backend domains while remaining grouped with the server code that composes them.

Map

Package What it owns
api Kubernetes API constants and error normalisation.
agent-sandbox SandboxClaim realization and exact Pod-to-lease verification.
auth OIDC login, sessions, and request-principal resolution.
workload-identity Kubernetes TokenReview and bounded workload identities.
history-store KurrentDB-backed append-only stream history.
http Express transport plumbing.
memory-gateway-client Authenticated memory reads with fail-closed writes.
mcp-remote-client Bounded HTTPS transport for MCP discovery, tool listing and admitted tool calls.
oci-registry Imports checked OCI images into one configured registry repository by digest.
organization-membership-gateway Projected-token-authenticated HTTPS transport to Fleet membership and billing.
prisma-unit-of-work The shared transaction envelope: explicit isolation and bounded retry of proven rollbacks.
workflows Engine-neutral saved workflow tasks, guardrails, scheduling helpers, adapters, and test support.
 inbound request ──► http ──► auth ──► backend domain route
                                  β”‚
                  api ────────────
 workload identity ─► workload routes

Dependency rule for this tier

These packages carry type:lib, layer:infra, and a bounded scope:* tag. They may use models, contracts, utilities, observability, and explicitly allowed server/infra peers, but never import a backend domain or app entrypoint. Public imports use @opencrane/backend/server/infra/<library>.

See also