Recipe

agenta-api

The agent workspace's control-plane API on Kubernetes via the helm provider's Workload synthesis: a stateless Deployment plus a ClusterIP Service on the HTTP port other workloads of the platform call. The service keeps no durable state of its own — the relational backend, the cache, the queue and the object store are the systems of record — so it renders stateless, with no persistent volume and no headless Service. Each backing system's identity arrives on .context.inject.env and is composed here into the single connection string its client reads. The two relational connections are rendered password-free: the password is delivered beside them as an env secret reference and named inside each URL in the platform's own runtime-substitution form, so the plaintext never appears in the rendered manifest even though the client receives one URL. With no credential attached the Recipe uses inline development defaults, and with one attached the value is supplied through the credential subsystem. A cache or queue publishing valkey-tls or redis-tls is reached over TLS, trusting that connection's server_ca or the image's store. The object store's secret key is the exception: it has no default, so a store connection carrying no credential halts the build, naming it, unless its values set unauthenticated: true, and then no secret key is sent. provides.host is the bare, self-contained in-cluster service name of the synthesized Service — it carries no namespace, so the recipe is independent of where it is deployed. A consumer in another namespace qualifies the host with the target namespace on its own side (caller-side routing), and assembles its own URL rather than reusing provides.endpoint.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:a3c1dcd5a581b3a60f7cb19cc893772b9702ed0c91e0337b0218697e7448d1db
Published
2026-11-10T10:21:42Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:dfbe5a7b4ee3f6d3d65a0fbfc3fd85154ec8ab6708708e1035764e0a0b636f27

Reference at this version

oci://hub.aggrega.ai/recipe/helm/agenta-api:1.0.0
Target
—
Implements
core/ai-agent/agenta-api:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.rendered_name }}-default
port{{ .infra.port }}
endpointhttp://{{ .context.rendered_name }}-default:{{ .infra.port }}
protocolhttp

Workload

Workload · form: stateless · replicas: 1 · containers: main

Locals

No locals declared.

Values mapping

No values mapping declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

  • implementsimplementscontract compatible

    core/ai-agent/agenta-api:1.0.0

    All required outputs are satisfied and every provided output is named in the contract.

Used by

Nothing in the catalog depends on this entity.

Recipe concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy