eai-core-infra

Python package to manage core Pulumi infrastructure resources for ExtensibilityAI-provided deployments.

Install

From PyPI:

pip install eai-core-infra
# or
uv add eai-core-infra

2.0 is a breaking release (no deprecation shims). Pin eai-core-infra<2 until you migrate; see docs/MIGRATION-2.0.md.

Database pooler (PgBouncer)

Opt-in per app stack with <cloud>.db.pooler. Absent or enabled: false changes nothing. An app owns a pooler in its namespace:

cloud:
  db:
    flags: {max_connections: "100"}   # optional; enables the connection-budget check
    pooler:
      enabled: true
      replicas: 2                      # fixed; never autoscaled
      defaultPoolSize: 4               # pool for DATABASE_NAME
      pools: {api: 8, workers: 24}     # named pools: DATABASE_POOL_<NAME>=<db>__<name>
      clients:                         # other apps' DB users allowed through
        - {user: my-consumer, namespace: my-consumer, maxConnections: 6}

Or it is a client of another app's pooler:

cloud:
  db:
    pooler: {enabled: true, namespace: owner-app, pool: workers}

Server connections: replicas × (Σ pool sizes + reservePoolSize per pool + Σ client maxConnections). With db.flags.max_connections, parsing checks that this, plus directReserve and 3 superuser connections, fits.
Transaction mode (the default) doesn't support session state across transactions:
- no session SET (use SET LOCAL);
- no session advisory locks (use pg_advisory_xact_lock);
- no LISTEN/NOTIFY and no WITH HOLD cursors.
Protocol-level prepared statements work (maxPreparedStatements). Don't hold a transaction open across slow work.
Migrations and admin connect directly, through DATABASE_DIRECT_HOST and DATABASE_DIRECT_PORT.

The infra library that owns the stack (e.g. eai-web-app-infra) calls create_pgbouncer and writes the app-env keys.

Test

uv sync --extra dev
uv run pytest

The guardrail suites (layout, import rules, contracts, models) and the resource-graph snapshots run on eai_core_infra.testing, which other eai-*-infra packages use too (pip install "eai-core-infra[testing]"). Describe the package with a GuardrailSpec and call one assert_* per suite. RECORD_ALLOWLISTS=1 rewrites the ratchet allowlists and RECORD_SNAPSHOTS=1 rewrites snapshots; review every added line.

Pre-commit

Hooks mirror CI lint and tests (ruff check, pytest):

uv tool install pre-commit   # once
pre-commit install
pre-commit run --all-files   # optional manual run

License

Apache-2.0

Metadata

Release files for eai-core-infra 2.2.0

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

Source distribution (sdist)

Source distribution for eai-core-infra 2.2.0
File	Size	Uploaded
eai_core_infra-2.2.0.tar.gz	738.4 kB	Oct 8, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for eai-core-infra 2.2.0
File	Interpreter	ABI	Platform	Reset
eai_core_infra-2.2.0-py3-none-any.whl 747.7 kB Oct 8, 2026	Python 3	none	any	Details

Total release size: 1.5 MB

Release files / eai_core_infra-2.2.0.tar.gz

Download URL	eai_core_infra-2.2.0.tar.gz
Size	738.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`05dae3f5f43dc23eac2e35966498d2076a4127f3bfa76c187ffba234bb76f4d0`
BLAKE2b-256 checksum How to use checksums	`fde164f75a5704dcf269c5d8b05d629d574f2e56d46980f2e21ec1abdd78f1bd`
Upload date	Oct 8, 2026
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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ExtensibilityAI/eai-core-infra
Publishing commit: github.com/ExtensibilityAI/eai-core-infra/tree/d1bd7046f5699bb2bc7332076a8dae4ebfcdaa1a

Workflow

Publishing configuration: github.com/ExtensibilityAI/eai-core-infra/blob/d1bd7046f5699bb2bc7332076a8dae4ebfcdaa1a/.github/workflows/publish-pypi.yml
Publishing logs: github.com/ExtensibilityAI/eai-core-infra/actions/runs/37790068742/attempts/1

Artifact

Subject: eai_core_infra-2.2.0.tar.gz
SHA-256 checksum: 05dae3f5f43dc23eac2e35966498d2076a4127f3bfa76c187ffba234bb76f4d0 Verifying attestations

Release files / eai_core_infra-2.2.0-py3-none-any.whl

Download URL	eai_core_infra-2.2.0-py3-none-any.whl
Size	747.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f29bf5d66a55c9fbc7c4fe5e5246c1238095ec1781764ccf59e5b002f7a4f916`
BLAKE2b-256 checksum How to use checksums	`f7e57697c33f84797c4febc314ff150d7bd3e2f77a3b880cf42c2cc60c982666`
Upload date	Oct 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ExtensibilityAI/eai-core-infra
Publishing commit: github.com/ExtensibilityAI/eai-core-infra/tree/d1bd7046f5699bb2bc7332076a8dae4ebfcdaa1a

Workflow

Publishing configuration: github.com/ExtensibilityAI/eai-core-infra/blob/d1bd7046f5699bb2bc7332076a8dae4ebfcdaa1a/.github/workflows/publish-pypi.yml
Publishing logs: github.com/ExtensibilityAI/eai-core-infra/actions/runs/37790068742/attempts/1

Artifact

Subject: eai_core_infra-2.2.0-py3-none-any.whl
SHA-256 checksum: f29bf5d66a55c9fbc7c4fe5e5246c1238095ec1781764ccf59e5b002f7a4f916 Verifying attestations