Files
orchestration_engine/orchestration/config.py
Jonathan Boniface 83df77005a feat: keep delivered work in S3-compatible object storage (ADR-0004 phase 3)
The store's rules now sit on a Blobs layer: a folder, as before, or a
prefix in an S3-compatible bucket (MinIO locally), chosen by STORE_BACKEND.
The layout is the same in both; the record is written last.

- S3_BUCKET, S3_PREFIX, S3_ENDPOINT_URL, S3_REGION; AWS credentials
- an s3 extra (boto3), installed in the image; moto for tests
- every store test runs on both kinds of storage

Retention, the platform's sign-in and each kept file as a platform
artifact are left: the last needs the platform's S3 backend, which it does
not yet have.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-21 21:08:39 +01:00

48 lines
1.9 KiB
Python

"""The Orchestration engine's settings, from the environment or `.env`."""
from __future__ import annotations
from pydantic_settings import BaseSettings, SettingsConfigDict
class OrchestrationSettings(BaseSettings):
model_config = SettingsConfigDict(
env_file=".env", env_file_encoding="utf-8", extra="ignore"
)
AGENT_NAME: str = "orchestration_engine"
AGENT_VERSION: str = "0.1.0"
LOG_LEVEL: str = "INFO"
A2A_HOST: str = "0.0.0.0"
A2A_PORT: int = 8080
A2A_PUBLIC_URL: str | None = None
# The agents it routes to: a YAML file of `agents: [{work, url, description}]`.
AGENTS_FILE: str = "agents.yaml"
# While an agent works, report that it still is at this interval, so a caller
# that takes a silent stream for a dead one does not retry (ADR-0003).
HEARTBEAT_SECONDS: float = 60
# How long to wait to connect to an agent. Reading waits as long as the
# agent's work takes.
CONNECT_TIMEOUT_SECONDS: float = 10
# What agents deliver is kept and served at signed links (ADR-0004): in a folder
# (`volume`, STORE_DIR; unset, nothing is kept) or in an S3-compatible bucket
# (`s3`). The bucket's credentials are the standard AWS_ACCESS_KEY_ID and
# AWS_SECRET_ACCESS_KEY.
STORE_BACKEND: str = "volume"
STORE_DIR: str | None = None
S3_BUCKET: str | None = None
S3_PREFIX: str = ""
S3_ENDPOINT_URL: str | None = None # MinIO, or another S3-compatible service
S3_REGION: str = "us-east-1"
# The base of every link: the address a browser reaches this service at, which
# is not its address inside the platform's network. Unset: A2A_PUBLIC_URL.
PUBLIC_URL: str | None = None
# The secret links are signed with. Unset: one is made at start-up, and links
# stop working when the service restarts.
LINK_SECRET: str | None = None
# How long a link works; 0 for always.
LINK_TTL_SECONDS: int = 30 * 24 * 3600