agentseek-api 0.2.1__tar.gz → 0.2.2__tar.gz

{agentseek_api-0.2.1 → agentseek_api-0.2.2}/.env.example

@@ -8,6 +8,7 @@ AGENTSEEK_GRAPHS=
 AUTH_MODULE_PATH=
 
 # Redis worker stream replay buffer.
+# WORKER_CONCURRENT_JOBS=10
 # REDIS_STREAM_MAXLEN=10000
 # REDIS_STREAM_TTL_SECONDS=3600
 

{agentseek_api-0.2.1 → agentseek_api-0.2.2}/.github/workflows/ci.yml

@@ -82,6 +82,18 @@ jobs:
           uv run python -c
           "from pathlib import Path; import subprocess; out = Path('.tmp/agentseek.Dockerfile'); out.parent.mkdir(exist_ok=True); subprocess.run(['uv', 'run', 'agentseek-api', 'dockerfile', '--config', 'examples/external_graph/manifest.json', str(out)], check=True); text = out.read_text(encoding='utf-8'); assert 'ENV PYTHONPATH=/deps/agent' in text; assert 'ENV AGENTSEEK_GRAPHS=/deps/agent/examples/external_graph/manifest.json' in text"
 
+      - name: CLI config, host environment, and process tests
+        run: >-
+          uv run pytest
+          tests/unit/test_cli.py
+          tests/unit/test_graph_manifest.py
+          tests/unit/test_dotenv_adapter.py
+          tests/unit/test_runtime_environment.py
+          tests/unit/test_runtime_entrypoint.py
+          tests/unit/test_process_supervisor.py
+          tests/integration/test_cli_runtime_processes.py
+          -q
+
       - name: Sync embedded SeekDB extra for serve smoke
         if: runner.os == 'Linux' || (runner.os == 'macOS' && runner.arch == 'ARM64')
         run: uv sync --dev --extra embedded
@@ -90,8 +102,9 @@ jobs:
         if: runner.os == 'Linux' || (runner.os == 'macOS' && runner.arch == 'ARM64')
         run: uv run python scripts/test_cli_serve_smoke.py
 
-      - name: CLI config and Docker planning tests
-        run: uv run pytest tests/unit/test_cli.py tests/unit/test_graph_manifest.py -q
+      - name: Minimum direct dependency compatibility
+        if: runner.os == 'Linux'
+        run: uv run python scripts/test_minimum_cli_dependencies.py
 
   embedded-seekdb-smoke:
     name: Embedded SeekDB Smoke

agentseek_api-0.2.2/CHANGELOG.md

@@ -0,0 +1,88 @@
+# Changelog
+
+Notable changes to AgentSeek API are documented in this file.
+
+## Unreleased
+
+## 0.2.2 - 2026-08-16
+
+### Highlights
+
+- Added bounded parallel Redis job execution within a worker process. Set
+  `WORKER_CONCURRENT_JOBS` to control the limit; the default is `10`.
+- Aligned assistant and run `config.configurable` / `context` handling with the
+  LangGraph API contract, including assistant defaults and legacy configurable
+  access for graphs without a context schema.
+- Defined one deterministic environment-ownership contract for the `dev`,
+  `serve`, `worker`, and `scheduler` host runtimes.
+
+### Fixed
+
+- Made Redis job acknowledgement conditional on ownership of the active worker
+  lease, and stopped scheduling safely when a job fails or the lease is lost.
+- Rejected client requests that provide both non-empty `config.configurable` and
+  `context`, mirrored either input into the other representation, and merged
+  assistant configuration into run configuration without discarding nested
+  defaults.
+- Made inherited host environment keys, including explicit empty strings,
+  authoritative over config and CLI dotenv sources.
+- Parsed each dotenv source independently with strict malformed-file handling,
+  and distinguished valueless `KEY` from explicit empty `KEY=`.
+- Started `worker` and `scheduler` in fresh child processes so their settings
+  are built after the resolved environment is installed.
+- Added bounded signal forwarding and descendant-process cleanup for `serve`,
+  `worker`, and `scheduler` across supported platforms.
+- Kept version, help, and Dockerfile rendering independent of runtime settings
+  validation.
+- Fell back to an ASCII CLI banner when a legacy Windows console cannot encode
+  the Unicode banner.
+
+### Upgrade notes
+
+- Redis workers now execute up to `10` jobs concurrently by default. Set
+  `WORKER_CONCURRENT_JOBS=1` to retain the previous serial behavior.
+- Clients must not send both non-empty `config.configurable` and `context` in
+  one assistant or run request; such requests now return HTTP 400. Prefer
+  `context` for new integrations.
+- For `dev`, `serve`, `worker`, and `scheduler`, dotenv interpolation is
+  supported only against the inherited environment and earlier bindings in the
+  same physical file.
+- For those host runtime commands, missing, malformed, and non-UTF-8 dotenv
+  sources fail closed with status 2 before a runtime child starts.
+- Dependency resolution now requires SQLAlchemy 2.0.12 or newer, LangGraph
+  1.0.6 or newer, LangChain Core 1.2.5 or newer, and MCP 1.27.1 through the 1.x
+  series. `python-dotenv` 1.0 through 1.2 is now a direct dependency.
+
+## 0.2.1 - 2026-07-14
+
+### Fixed
+
+- Preserved empty JSON arrays in Redis thread-stream events by avoiding a Lua
+  cjson decode/encode round trip, while keeping generated envelope fields
+  authoritative.
+- Mirrored completed tool, human, and system messages to `messages-tuple` when
+  requested so LangGraph SDK clients receive tool results before final-answer
+  streaming completes.
+
+### Upgrade notes
+
+- No schema or configuration migration is required from 0.2.0.
+
+## 0.2.0 - 2026-07-12
+
+### Highlights
+
+- Expanded the Crons API to align its request, response, filtering, sorting,
+  selection, and lifecycle behavior with the LangGraph Platform contract.
+- Moved Redis-worker run and protocol event persistence from SQL to bounded
+  Redis Streams, removing metadata-database writes from the streaming hot path.
+- Preserved UTF-8 output across SSE, wait, and A2A JSON responses while keeping
+  active thread event retention bounded without dropping live events.
+- Upgraded checkpoint integration to `langchain-oceanbase` 0.6.0.
+
+### Upgrade notes
+
+- Drain active Redis-worker runs before upgrading. Stream-event rows written to
+  SQL by earlier versions are not imported into Redis Streams.
+- Redis stream replay is bounded by `REDIS_STREAM_MAXLEN` and
+  `REDIS_STREAM_TTL_SECONDS`; review these settings for long-running workloads.

agentseek_api-0.2.1/README.md → agentseek_api-0.2.2/PKG-INFO

@@ -1,3 +1,35 @@
+Metadata-Version: 2.5
+Name: agentseek-api
+Version: 0.2.2
+Summary: AgentSeek API core runtime with OceanBase checkpoints.
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: aiomysql>=0.2.0
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: asyncpg>=0.29.0
+Requires-Dist: cryptography>=45.0.0
+Requires-Dist: fastapi>=0.110.1
+Requires-Dist: greenlet>=3.1.0
+Requires-Dist: langchain-anthropic>=1.0.0
+Requires-Dist: langchain-core>=1.2.5
+Requires-Dist: langchain-oceanbase==0.6.0
+Requires-Dist: langchain-openai>=1.0.0
+Requires-Dist: langchain>=0.3.9
+Requires-Dist: langgraph-sdk>=0.3.5
+Requires-Dist: langgraph>=1.0.6
+Requires-Dist: mcp<2,>=1.27.1
+Requires-Dist: pydantic-settings>=2.4.0
+Requires-Dist: pydantic>=2.8.0
+Requires-Dist: pymysql>=1.1.0
+Requires-Dist: python-dotenv<1.3,>=1.0
+Requires-Dist: redis>=5.0.0
+Requires-Dist: scalar-fastapi>=1.0.3
+Requires-Dist: sqlalchemy>=2.0.12
+Requires-Dist: uvicorn>=0.30.0
+Provides-Extra: embedded
+Requires-Dist: langchain-oceanbase[pyseekdb]==0.6.0; extra == 'embedded'
+Description-Content-Type: text/markdown
+
 # AgentSeek API
 
 **English** | [中文](README.zh-CN.md)
@@ -185,7 +217,7 @@ When the server starts it prints the banner and local URLs:
 ╠═╣│ ┬├┤ │││ │ ╚═╗├┤ ├┤ ├┴┐
 ╩ ╩└─┘└─┘┘└┘ ┴ ╚═╝└─┘└─┘┴ ┴
 
-     AgentSeek v0.2.1
+     AgentSeek v0.2.2
 
 - 🚀 API: http://localhost:2024
 - 📚 Docs: http://localhost:2024/docs
@@ -260,7 +292,35 @@ When running from this repository, use `uv run agentseek-api ...`.
 
 - `-c, --config PATH`: explicit `agentseek.json`, `langgraph.json`, or manifest
   path
-- `--env-file PATH`: dotenv-style file loaded into the runtime environment
+- `--env-file PATH`: host-runtime dotenv source
+
+### Host runtime environment
+
+For `dev`, `serve`, `worker`, and `scheduler`, direct assignments are applied in
+this order:
+
+1. the dotenv path named by config `env`;
+2. the literal config `env` mapping and `auth.path`;
+3. the CLI `--env-file`;
+4. the environment inherited by `agentseek-api`.
+
+The inherited environment is authoritative by key presence. This includes an
+explicit empty value. A lower source can fill an absent key, but cannot replace
+an inherited `KEY=`.
+
+Each dotenv file is evaluated independently. It can reference the inherited
+environment and earlier bindings in the same physical file; it cannot reference
+a config mapping or another dotenv file. Later assignment does not recompute an
+earlier interpolated value.
+
+In dotenv syntax, a bare `KEY` is valid but contributes no assignment, while
+`KEY=` contributes an explicit empty string. Missing files, invalid UTF-8, and
+malformed syntax stop the command before a runtime child starts.
+
+The CLI applies command-owned values after this merge: the selected config path
+becomes `AGENTSEEK_GRAPHS`, and `dev` forces `STUDIO_AUTH_LOCAL_DEV=true`.
+Host and port options are passed as child argv and do not rewrite environment
+keys with similar names.
 
 ### Common usage
 
@@ -622,6 +682,8 @@ parent api build --config ./langgraph.json -t my-api:dev
   - `REDIS_URL=redis://127.0.0.1:6379/0`
   - `REDIS_RUN_QUEUE_KEY=agentseek:runs:pending`
   - `REDIS_RUN_PROCESSING_KEY=agentseek:runs:processing`
+  - `WORKER_CONCURRENT_JOBS=10` bounds concurrently executing jobs in one
+    worker process
   - `REDIS_WORKER_LOCK_KEY=agentseek:worker:active`
   - `REDIS_WORKER_LOCK_TTL_SECONDS=30`
   - `REDIS_STREAM_MAXLEN=10000`

agentseek_api-0.2.1/PKG-INFO → agentseek_api-0.2.2/README.md

@@ -1,34 +1,3 @@
-Metadata-Version: 2.4
-Name: agentseek-api
-Version: 0.2.1
-Summary: AgentSeek API core runtime with OceanBase checkpoints.
-License-File: LICENSE
-Requires-Python: >=3.12
-Requires-Dist: aiomysql>=0.2.0
-Requires-Dist: aiosqlite>=0.20.0
-Requires-Dist: asyncpg>=0.29.0
-Requires-Dist: cryptography>=45.0.0
-Requires-Dist: fastapi>=0.110.1
-Requires-Dist: greenlet>=3.1.0
-Requires-Dist: langchain-anthropic>=1.0.0
-Requires-Dist: langchain-core>=1.0.0
-Requires-Dist: langchain-oceanbase==0.6.0
-Requires-Dist: langchain-openai>=1.0.0
-Requires-Dist: langchain>=0.3.9
-Requires-Dist: langgraph-sdk>=0.3.5
-Requires-Dist: langgraph>=1.0.3
-Requires-Dist: mcp>=1.27.1
-Requires-Dist: pydantic-settings>=2.4.0
-Requires-Dist: pydantic>=2.8.0
-Requires-Dist: pymysql>=1.1.0
-Requires-Dist: redis>=5.0.0
-Requires-Dist: scalar-fastapi>=1.0.3
-Requires-Dist: sqlalchemy>=2.0.0
-Requires-Dist: uvicorn>=0.30.0
-Provides-Extra: embedded
-Requires-Dist: langchain-oceanbase[pyseekdb]==0.6.0; extra == 'embedded'
-Description-Content-Type: text/markdown
-
 # AgentSeek API
 
 **English** | [中文](README.zh-CN.md)
@@ -216,7 +185,7 @@ When the server starts it prints the banner and local URLs:
 ╠═╣│ ┬├┤ │││ │ ╚═╗├┤ ├┤ ├┴┐
 ╩ ╩└─┘└─┘┘└┘ ┴ ╚═╝└─┘└─┘┴ ┴
 
-     AgentSeek v0.2.1
+     AgentSeek v0.2.2
 
 - 🚀 API: http://localhost:2024
 - 📚 Docs: http://localhost:2024/docs
@@ -291,7 +260,35 @@ When running from this repository, use `uv run agentseek-api ...`.
 
 - `-c, --config PATH`: explicit `agentseek.json`, `langgraph.json`, or manifest
   path
-- `--env-file PATH`: dotenv-style file loaded into the runtime environment
+- `--env-file PATH`: host-runtime dotenv source
+
+### Host runtime environment
+
+For `dev`, `serve`, `worker`, and `scheduler`, direct assignments are applied in
+this order:
+
+1. the dotenv path named by config `env`;
+2. the literal config `env` mapping and `auth.path`;
+3. the CLI `--env-file`;
+4. the environment inherited by `agentseek-api`.
+
+The inherited environment is authoritative by key presence. This includes an
+explicit empty value. A lower source can fill an absent key, but cannot replace
+an inherited `KEY=`.
+
+Each dotenv file is evaluated independently. It can reference the inherited
+environment and earlier bindings in the same physical file; it cannot reference
+a config mapping or another dotenv file. Later assignment does not recompute an
+earlier interpolated value.
+
+In dotenv syntax, a bare `KEY` is valid but contributes no assignment, while
+`KEY=` contributes an explicit empty string. Missing files, invalid UTF-8, and
+malformed syntax stop the command before a runtime child starts.
+
+The CLI applies command-owned values after this merge: the selected config path
+becomes `AGENTSEEK_GRAPHS`, and `dev` forces `STUDIO_AUTH_LOCAL_DEV=true`.
+Host and port options are passed as child argv and do not rewrite environment
+keys with similar names.
 
 ### Common usage
 
@@ -653,6 +650,8 @@ parent api build --config ./langgraph.json -t my-api:dev
   - `REDIS_URL=redis://127.0.0.1:6379/0`
   - `REDIS_RUN_QUEUE_KEY=agentseek:runs:pending`
   - `REDIS_RUN_PROCESSING_KEY=agentseek:runs:processing`
+  - `WORKER_CONCURRENT_JOBS=10` bounds concurrently executing jobs in one
+    worker process
   - `REDIS_WORKER_LOCK_KEY=agentseek:worker:active`
   - `REDIS_WORKER_LOCK_TTL_SECONDS=30`
   - `REDIS_STREAM_MAXLEN=10000`

{agentseek_api-0.2.1 → agentseek_api-0.2.2}/README.zh-CN.md

@@ -181,7 +181,7 @@ uv run agentseek-api dev --config ./langgraph.json
 ╠═╣│ ┬├┤ │││ │ ╚═╗├┤ ├┤ ├┴┐
 ╩ ╩└─┘└─┘┘└┘ ┴ ╚═╝└─┘└─┘┴ ┴
 
-     AgentSeek v0.2.1
+     AgentSeek v0.2.2
 
 - 🚀 API: http://localhost:2024
 - 📚 Docs: http://localhost:2024/docs

{agentseek_api-0.2.1 → agentseek_api-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentseek-api"
-version = "0.2.1"
+version = "0.2.2"
 description = "AgentSeek API core runtime with OceanBase checkpoints."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -9,22 +9,23 @@ dependencies = [
     "uvicorn>=0.30.0",
     "pydantic>=2.8.0",
     "pydantic-settings>=2.4.0",
-    "sqlalchemy>=2.0.0",
+    "sqlalchemy>=2.0.12",
     "greenlet>=3.1.0",
     "asyncpg>=0.29.0",
     "aiomysql>=0.2.0",
     "aiosqlite>=0.20.0",
     "redis>=5.0.0",
-    "langgraph>=1.0.3",
+    "langgraph>=1.0.6",
     "langgraph-sdk>=0.3.5",
-    "langchain-core>=1.0.0",
+    "langchain-core>=1.2.5",
     "langchain-openai>=1.0.0",
     "langchain-anthropic>=1.0.0",
     "langchain-oceanbase==0.6.0",
     "cryptography>=45.0.0",
     "pymysql>=1.1.0",
     "langchain>=0.3.9",
-    "mcp>=1.27.1",
+    "mcp>=1.27.1,<2",
+    "python-dotenv>=1.0,<1.3",
     "scalar-fastapi>=1.0.3",
 ]
 
@@ -39,7 +40,7 @@ agentseek-api = "agentseek_api.cli:main"
 [dependency-groups]
 dev = [
     "pytest>=8.0.0",
-    "pytest-asyncio>=0.23.0",
+    "pytest-asyncio>=0.23.5",
     "pytest-cov>=5.0.0",
     "httpx>=0.27.0",
     "ruff>=0.6.0",

{agentseek_api-0.2.1 → agentseek_api-0.2.2}/scripts/test-redis-runtime.sh

@@ -18,13 +18,23 @@ SEEKDB_DOCKER_IMAGE="${SEEKDB_DOCKER_IMAGE:-}"
 OCEANBASE_DOCKER_MODE="${OCEANBASE_DOCKER_MODE:-mini}"
 STATE_DIR="${STATE_DIR:-$ROOT_DIR/.tmp/redis-runtime}"
 RESUME_STATE_FILE="$STATE_DIR/resume-state.json"
+SHUTDOWN_STATE_FILE=""
+REDIS_WORKER_LOCK_KEY="${REDIS_WORKER_LOCK_KEY:-agentseek:worker:active}"
+WORKER_CONCURRENT_JOBS="${WORKER_CONCURRENT_JOBS:-10}"
 
 cleanup() {
-  stop_worker
+  local status=$?
+
+  trap - EXIT
+  stop_worker >/dev/null 2>&1 || true
   docker rm -f "$API_CONTAINER" >/dev/null 2>&1 || true
   docker rm -f "$REDIS_CONTAINER" >/dev/null 2>&1 || true
   docker rm -f "$BACKEND_CONTAINER" >/dev/null 2>&1 || true
   docker network rm "$NETWORK_NAME" >/dev/null 2>&1 || true
+  if [[ -n "$SHUTDOWN_STATE_FILE" ]]; then
+    rm -f "$SHUTDOWN_STATE_FILE" || true
+  fi
+  exit "$status"
 }
 
 print_logs() {
@@ -197,19 +207,70 @@ PY
 }
 
 stop_worker() {
-  if docker ps --format '{{.Names}}' | grep -Fxq "$WORKER_CONTAINER"; then
-    docker stop -t 10 "$WORKER_CONTAINER" >/dev/null 2>&1 || true
+  local timeout="${1:-10}"
+  local container_id
+  local running
+  local status
+
+  if container_id="$(docker ps -aq --filter "name=^/${WORKER_CONTAINER}$")"; then
+    :
+  else
+    status=$?
+    print_logs >&2
+    return "$status"
+  fi
+  if [[ -z "$container_id" ]]; then
+    return 0
+  fi
+
+  if running="$(docker inspect --format '{{.State.Running}}' "$container_id")"; then
+    :
+  else
+    status=$?
+    print_logs >&2
+    return "$status"
+  fi
+  if [[ "$running" == "true" ]]; then
+    if docker stop -t "$timeout" "$WORKER_CONTAINER" >/dev/null; then
+      :
+    else
+      status=$?
+      print_logs >&2
+      return "$status"
+    fi
+  fi
+  if docker rm -f "$WORKER_CONTAINER" >/dev/null; then
+    :
+  else
+    status=$?
+    print_logs >&2
+    return "$status"
+  fi
+  if docker exec "$REDIS_CONTAINER" redis-cli DEL "$REDIS_WORKER_LOCK_KEY" >/dev/null; then
+    return 0
+  else
+    status=$?
+    print_logs >&2
+    return "$status"
   fi
-  docker rm -f "$WORKER_CONTAINER" >/dev/null 2>&1 || true
 }
 
 start_worker() {
-  stop_worker
-  docker run -d \
+  local status
+
+  if stop_worker; then
+    :
+  else
+    status=$?
+    return "$status"
+  fi
+  if docker run -d \
     --name "$WORKER_CONTAINER" \
     --network "$NETWORK_NAME" \
     -e EXECUTOR_BACKEND=redis \
     -e REDIS_URL="redis://${REDIS_CONTAINER}:6379/0" \
+    -e REDIS_WORKER_LOCK_KEY="${REDIS_WORKER_LOCK_KEY}" \
+    -e WORKER_CONCURRENT_JOBS="${WORKER_CONCURRENT_JOBS}" \
     -e SEEKDB_URL="${SEEKDB_URL}" \
     -e OCEANBASE_HOST="${BACKEND_CONTAINER}" \
     -e OCEANBASE_PORT="${OCEANBASE_PORT}" \
@@ -217,7 +278,28 @@ start_worker() {
     -e OCEANBASE_PASSWORD="${OCEANBASE_PASSWORD}" \
     -e OCEANBASE_DB_NAME="${OCEANBASE_DB_NAME}" \
     "$IMAGE_TAG" \
-    python -m agentseek_api.cli worker >/dev/null
+    python -m agentseek_api.cli worker >/dev/null; then
+    return 0
+  else
+    status=$?
+    print_logs >&2
+    return "$status"
+  fi
+}
+
+run_probe() {
+  local status
+
+  if uv run python scripts/verify_worker_concurrency.py \
+    --base-url "$BASE_URL" \
+    --redis-url "redis://127.0.0.1:${REDIS_HOST_PORT}/0" \
+    "$@"; then
+    return 0
+  else
+    status=$?
+    print_logs >&2
+    return "$status"
+  fi
 }
 
 start_backend() {
@@ -259,6 +341,7 @@ set_backend_defaults "$SEEKDB_DOCKER_BACKEND"
 docker network rm "$NETWORK_NAME" >/dev/null 2>&1 || true
 docker network create "$NETWORK_NAME" >/dev/null
 mkdir -p "$STATE_DIR"
+SHUTDOWN_STATE_FILE="$(mktemp "$STATE_DIR/shutdown-state.XXXXXX")"
 
 uv run agentseek-api build --config "$CONFIG_PATH" -t "$IMAGE_TAG"
 
@@ -274,7 +357,10 @@ docker run -d \
 wait_for_redis
 
 if ! AGENTSEEK_TEST_REDIS_URL="redis://127.0.0.1:${REDIS_HOST_PORT}/0" \
-  uv run pytest tests/integration/test_live_redis_stream_persistence.py -q; then
+  uv run pytest \
+    tests/integration/test_live_redis_stream_persistence.py \
+    tests/integration/test_live_redis_queue.py \
+    -q; then
   print_logs
   exit 1
 fi
@@ -319,3 +405,21 @@ if ! uv run python scripts/verify_docker_api.py --base-url "$BASE_URL" --mode re
   print_logs
   exit 1
 fi
+
+WORKER_CONCURRENCY_SUITE_STARTED_SECONDS=$SECONDS
+echo "worker concurrency probe suite started" >&2
+
+WORKER_CONCURRENT_JOBS=10
+start_worker
+run_probe --mode fanout
+
+WORKER_CONCURRENT_JOBS=2
+start_worker
+run_probe --mode bounded
+run_probe --mode failure
+run_probe --mode shutdown-seed >"$SHUTDOWN_STATE_FILE"
+stop_worker 1
+start_worker
+run_probe --mode shutdown-check --state-file "$SHUTDOWN_STATE_FILE"
+
+echo "worker concurrency probe suite completed in $((SECONDS - WORKER_CONCURRENCY_SUITE_STARTED_SECONDS))s" >&2

agentseek_api-0.2.2/scripts/test_minimum_cli_dependencies.py

@@ -0,0 +1,109 @@
+"""Verify host environment resolution with all direct dependency floors."""
+
+from __future__ import annotations
+
+import os
+import subprocess
+import sys
+import tempfile
+import tomllib
+from pathlib import Path
+
+
+def main() -> None:
+    repository = Path(__file__).resolve().parents[1]
+    project = tomllib.loads((repository / "pyproject.toml").read_text(encoding="utf-8"))
+    requirements = list(project["project"]["dependencies"])
+    requirements.append("pytest>=8.0.0")
+    requirements.append("pytest-asyncio>=0.23.5")
+
+    with tempfile.TemporaryDirectory(prefix="agentseek-minimum-") as directory:
+        environment = Path(directory) / ".venv"
+        subprocess.run(
+            [
+                "uv",
+                "venv",
+                "--python",
+                "3.12",
+                str(environment),
+            ],
+            check=True,
+        )
+        python = environment / (
+            "Scripts/python.exe" if sys.platform == "win32" else "bin/python"
+        )
+        subprocess.run(
+            [
+                "uv",
+                "pip",
+                "install",
+                "--python",
+                str(python),
+                "--resolution",
+                "lowest-direct",
+                *requirements,
+            ],
+            check=True,
+        )
+        subprocess.run(
+            [
+                "uv",
+                "pip",
+                "install",
+                "--python",
+                str(python),
+                "--no-deps",
+                "-e",
+                str(repository),
+            ],
+            check=True,
+        )
+
+        version = subprocess.run(
+            [
+                str(python),
+                "-c",
+                (
+                    "import importlib.metadata; "
+                    "print(importlib.metadata.version('python-dotenv'))"
+                ),
+            ],
+            check=True,
+            capture_output=True,
+            text=True,
+        )
+        assert version.stdout.strip() == "1.0.0"
+
+        cli_env = dict(os.environ)
+        cli_env.pop("PYTHONPATH", None)
+        cli_env["PORT"] = "not-an-integer"
+        version_result = subprocess.run(
+            [str(python), "-m", "agentseek_api.cli", "version"],
+            cwd=repository,
+            env=cli_env,
+            check=True,
+            capture_output=True,
+            text=True,
+        )
+        expected_version = project["project"]["version"]
+        assert version_result.stdout.strip() == f"agentseek-api {expected_version}"
+
+        test_env = dict(os.environ)
+        test_env.pop("PYTHONPATH", None)
+        subprocess.run(
+            [
+                str(python),
+                "-m",
+                "pytest",
+                "tests/unit/test_dotenv_adapter.py",
+                "tests/unit/test_runtime_environment.py",
+                "-q",
+            ],
+            cwd=repository,
+            env=test_env,
+            check=True,
+        )
+
+
+if __name__ == "__main__":
+    main()