Skip to main content

service-foundation

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

Current Status

2026.09.26.2205 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.26.2205

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.26.2205
File Size Uploaded Provenance
service_foundation-2026.9.26.2205.tar.gz 8.8 kB With provenance Details

Built distribution (wheel)

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

Total release size: 16.3 kB

Release files / service_foundation-2026.9.26.2205.tar.gz

Download URL service_foundation-2026.9.26.2205.tar.gz
Size 8.8 kB
Tags Source
SHA-256 checksum
How to use checksums
7ea0bddfc7ba4a3453d0f2c7c8c0992938231e32bab9342a3ac855776bf42837
BLAKE2b-256 checksum
How to use checksums
634a9c50e4d74613e16ab8af187b966bafd22878b6b8ffadea86cf4138dfc4cb
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 26, 2026.

Transparency log

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

Download URL service_foundation-2026.9.26.2205-py3-none-any.whl
Size 7.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cc36f474c36570dc87cc5a56e79e56dac06f4e63ca01bd99d81ce8bf9bccced7
BLAKE2b-256 checksum
How to use checksums
076751977930352ca3357a9b7e86de6ef152f71b16debff88601d0d3aa20e3ca
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 26, 2026.

Transparency log

Security for service-foundation 2026.9.26.2205

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.26.2205.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 26, 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