steve
daf07fd759
Add the async job submission API, webhook state notifications, and
artifact serving endpoints on top of the Phase 3 queue infrastructure.
Key changes:
- POST /jobs: async job submission with 202 + job_id ULID; optional
state_webhook_url for push notifications on state transitions
- GET /jobs/{id}: job status polling with result, error, and artifact
metadata; artifacts <= 256KB inlined, larger ones by URL reference
- GET /jobs/{id}/artifacts/{name}: raw artifact data serving
- Webhook dispatcher: at-least-once delivery with exponential backoff
(5 retries); optional HMAC-SHA256 signing (X-Foreman-Signature)
- ADR-0014: state_webhook_url only honored on POST /jobs, not sync
/api/chat (caller already blocks for result)
- Comprehensive tests for /jobs lifecycle, webhook delivery, HMAC
verification, artifact inline/URL threshold, and TTL pruning
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
33 lines
1000 B
Bash
33 lines
1000 B
Bash
# foreman configuration — all env vars are FOREMAN_* namespaced.
|
|
# Copy to .env and fill in values for local development.
|
|
|
|
# Listen address for the HTTP server (default: :8080)
|
|
FOREMAN_ADDR=:8080
|
|
|
|
# Base URL of the Ollama target (required)
|
|
FOREMAN_OLLAMA_URL=http://mac.tail:11434
|
|
|
|
# Optional bearer token foreman sends to the Ollama target
|
|
FOREMAN_OLLAMA_TOKEN=
|
|
|
|
# Optional bearer token callers must present to foreman
|
|
FOREMAN_TOKEN=
|
|
|
|
# Always-resident embedder model (e.g. nomic-embed-text, qwen3-embedding:0.6b)
|
|
FOREMAN_EMBED_MODEL=nomic-embed-text
|
|
|
|
# Path to the SQLite database file (default: foreman.db)
|
|
FOREMAN_DB_PATH=foreman.db
|
|
|
|
# How often to poll the target's /api/tags (default: 30s)
|
|
FOREMAN_POLL_INTERVAL=30s
|
|
|
|
# Optional HMAC key for signing webhook payloads (ADR-0005)
|
|
FOREMAN_WEBHOOK_SECRET=
|
|
|
|
# Maximum retry attempts for a job before marking as failed (default: 3)
|
|
FOREMAN_MAX_ATTEMPTS=3
|
|
|
|
# How long to retain completed/failed jobs before pruning (default: 24h)
|
|
FOREMAN_JOB_TTL=24h
|