Skip to main content

service-foundation

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

Current Status

2026.09.28.2257 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.2257

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

Built distribution (wheel)

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

Total release size: 16.3 kB

Release files / service_foundation-2026.9.28.2257.tar.gz

Download URL service_foundation-2026.9.28.2257.tar.gz
Size 8.8 kB
Tags Source
SHA-256 checksum
How to use checksums
a38673f8e228985a2172bc656b10f0ed882a86c062d9b33c6a452fb2bfb218a1
BLAKE2b-256 checksum
How to use checksums
6e1cede7cdde14fd8299af1126b881febfcd5f7354d16dabef2ea63d48163f71
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.2257-py3-none-any.whl

Download URL service_foundation-2026.9.28.2257-py3-none-any.whl
Size 7.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ccd4b326774e67655996ba60ce163c0352b9ffe632f2c010069791ca2e2a1497
BLAKE2b-256 checksum
How to use checksums
fc74eaca0bd852c40100f526d44199717c657c4f58b9932e91b126e1a937d9b5
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.2257

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.2257.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