Skip to main content

service-foundation

Foundations for standalone runnable services and host-side companion processes.

Current Status

2026.09.28.0221 is released together with app-foundation, connection-hub and project-board at one version (W322). It includes a generic host-relay lifecycle under service_foundation.host_relay:

  • HostRelayAdapter defines one asynchronous poll_once() domain boundary;
  • HostRelayRuntime owns repeated execution, health, stop, and bounded retry;
  • HostRelayPolicy defines poll and retry timing;
  • an adapter may return next_poll_seconds and implement wait_for_wakeup(timeout_seconds, stop_event) so a live transport can start the next reconciliation cycle immediately;
  • entry-point discovery uses service_foundation.host_relay.adapters for separately packaged adapters.
python -m pip install service-foundation

An adapter owns domain translation and returns bounded cycle metadata. The runtime emits lifecycle metadata and result-key names; it does not copy domain payloads into observer events.

Boundary

A standalone service needs a host layer around its application logic:

  • composition and launcher contracts;
  • browser-session and service-workload authentication surfaces;
  • service-owned session issuance and verification;
  • configuration, health, and readiness contracts;
  • migration invocation, while the application owns its migrations;
  • lifecycle for a local or remote companion process.

The host-relay runtime does not know MCP, Data Bus, credentials, agents, mail, journals, or any product vocabulary. A product composition root supplies an adapter, opens whatever governed transport that adapter needs, and translates transport events into wakeups. Poll timing remains reconciliation policy even when ordinary work is push-driven.

service-foundation does not import app-foundation, and app-foundation does not import service-foundation. Products may depend on either or both.

License: MIT. Source: https://github.com/elenaviter/app-ecosystem

Metadata

Release files for service-foundation 2026.9.28.221

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for service-foundation 2026.9.28.221
File Size Uploaded Provenance
service_foundation-2026.9.28.221.tar.gz 8.8 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for service-foundation 2026.9.28.221
File Interpreter ABI Platform
service_foundation-2026.9.28.221-py3-none-any.whl Python 3 none any Details

Total release size: 16.3 kB

Release files / service_foundation-2026.9.28.221.tar.gz

Download URL service_foundation-2026.9.28.221.tar.gz
Size 8.8 kB
Tags Source
SHA-256 checksum
How to use checksums
13053528a518b71f7b49c342c015f78d0755f4d2173e246ef5f5e51fc1688b11
BLAKE2b-256 checksum
How to use checksums
cad31d7831ea211b29c89c19075e0844a493540c1ad685b243f81a24641625e8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.

Transparency log

Release files / service_foundation-2026.9.28.221-py3-none-any.whl

Download URL service_foundation-2026.9.28.221-py3-none-any.whl
Size 7.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
aebc42572e4d9dd9b6927bf207f7eda102193761e449f47f228ec210e9fb28d0
BLAKE2b-256 checksum
How to use checksums
82bd91faa73fc46bd8f1d02830412de4e5e20e723d7182ed1c9eedb48b1376d4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.

Transparency log

Security for service-foundation 2026.9.28.221

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for service_foundation-2026.9.28.221.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page