Recipe

retrieval

The similarity-retrieval tool on Docker Compose: one service running the image the Release names in infra.image, listening on infra.port on the compose network, where an agent reaches it at the service's own name. Nothing is published to the host. The store the tool searches arrives on the tool's datastore socket, and its host, port and protocol reach the container as RETRIEVAL_TOOL_STORE_HOST, RETRIEVAL_TOOL_STORE_PORT and RETRIEVAL_TOOL_STORE_PROTOCOL beside the developer's match count, the names helm/retrieval-knative delivers them under; a connection writing an `inject:` block receives instead the names it dictates, as variables or as files from compose configs. It differs from the Knative realization in one way a reader must know: the service is one container that runs while the stack runs. Docker Compose has no autoscaler, so the tool does not scale to zero between calls and runs no second replica; an infra.min_replicas above one is refused by name, and infra.max_replicas, a ceiling one container never passes, is honoured as it stands. No control plane is involved, so infra.control_plane_present is not read. Reach for this realization under Docker Compose, and for helm/retrieval-knative on a Kubernetes cluster running Knative Serving. The component's own `inject:` block delivers its entries as a connection's are, and one reading a value of the tool alone replaces that value's default name. An arg entry, or any other mechanism, is refused by name.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:2f0b7828ca2ab558d8c372292595c479bc7e1abbce9229b872580e81b41cafac
Published
2026-11-15T08:09:27Z
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:dfeee537c3c3ad6431244ccd6ff009670fa4df8cb481318d85ca00432c95fff1

Reference at this version

oci://hub.aggrega.ai/recipe/compose/retrieval:1.0.0
Target
—
Implements
core/ai-tool/retrieval:1.0.1

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.instance_id }}
port{{ .infra.port }}
endpointhttp://{{ .context.instance_id }}:{{ .infra.port }}
protocolhttp

Workload

Workload · form: stateless · containers: main

Locals

NameTemplate
instance_id{{ .context.instance_id }}
inject_file_config_prefix{{ .context.instance_id }}-file-

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-tool/retrieval:1.0.1

    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