refactor(env): migrated environment variables from OMP_ to PI_ prefix and centralized access via getEnv()
- Migrated environment variable access from direct process.env to centralized getEnv() utility function across all packages. - Renamed environment variable prefix from OMP_ to PI_ throughout codebase (e.g., OMP_CODING_AGENT_DIR -> PI_CODING_AGENT_DIR). - Removed automatic environment variable migration from PI_ to OMP_ prefixes via migrate-env.ts module. - Removed env setting from configuration schema and applyEnvironmentVariables() method from settings. - Updated CI/CD build configuration to use PI_COMPILED flag instead of OMP_COMPILED. - Changed venvPath property in PythonRuntime from nullable (string | null) to optional (string | undefined).
This commit is contained in:
can1357
@@ -6,6 +6,7 @@
|
||||
- `jupyter-kernel-gateway` (`kernel_gateway` module) and `ipykernel` installed in the selected Python environment
|
||||
|
||||
Install:
|
||||
|
||||
```bash
|
||||
python -m pip install jupyter_kernel_gateway ipykernel
|
||||
```
|
||||
@@ -16,6 +17,7 @@ The Python tool uses a Jupyter Kernel Gateway and talks to it over REST and WebS
|
||||
By default it uses a shared local gateway so multiple pi instances reuse the same gateway process.
|
||||
|
||||
Shared-gateway startup flow:
|
||||
|
||||
1. Filter the environment and resolve the Python runtime (including venv detection)
|
||||
2. Acquire the shared gateway (reuse a healthy gateway or spawn `python -m kernel_gateway` on 127.0.0.1:PORT)
|
||||
3. Wait for gateway readiness (`GET /api/kernelspecs`)
|
||||
@@ -29,19 +31,21 @@ Instead of spawning a local gateway, you can connect to an already-running Jupyt
|
||||
|
||||
```bash
|
||||
# Connect to external gateway
|
||||
export OMP_PYTHON_GATEWAY_URL="http://127.0.0.1:8888"
|
||||
export PI_PYTHON_GATEWAY_URL="http://127.0.0.1:8888"
|
||||
|
||||
# Optional: auth token if gateway requires it (KG_AUTH_TOKEN)
|
||||
export OMP_PYTHON_GATEWAY_TOKEN="your-token-here"
|
||||
export PI_PYTHON_GATEWAY_TOKEN="your-token-here"
|
||||
```
|
||||
|
||||
When `OMP_PYTHON_GATEWAY_URL` is set:
|
||||
When `PI_PYTHON_GATEWAY_URL` is set:
|
||||
|
||||
- No local gateway process is spawned
|
||||
- Kernels are created on the external gateway
|
||||
- The gateway process is not killed on shutdown
|
||||
- Availability check uses `/api/kernelspecs` endpoint instead of local module check
|
||||
|
||||
This is useful for:
|
||||
|
||||
- Remote kernel execution
|
||||
- Shared kernel environments
|
||||
- Pre-configured gateway setups
|
||||
@@ -49,7 +53,7 @@ This is useful for:
|
||||
## Environment Propagation
|
||||
|
||||
- The kernel inherits a filtered environment (explicit allowlist + denylist)
|
||||
- Allowlisted prefixes include `LC_`, `XDG_`, and `OMP_`; known API-key vars are removed
|
||||
- Allowlisted prefixes include `LC_`, `XDG_`, and `PI_`; known API-key vars are removed
|
||||
- `PYTHONPATH` is passed through if present
|
||||
- Virtual environments are detected via `VIRTUAL_ENV`, `.venv/`, or `venv/` and preferred when present
|
||||
|
||||
@@ -65,18 +69,21 @@ Project modules override user modules with the same filename.
|
||||
## Kernel Modes
|
||||
|
||||
Settings under `python` control exposure and reuse:
|
||||
|
||||
- `toolMode`: `both` (default), `ipy-only`, `bash-only`
|
||||
- `kernelMode`: `session` (default) or `per-call`
|
||||
- `sharedGateway`: `true` (default). Setting to `false` throws an error because local (per-process) gateways are not supported; the shared gateway is required.
|
||||
|
||||
Mode behavior:
|
||||
|
||||
- `session`: reuse kernels per session id, serialize execution, evict after 5 minutes of idle time (max 4 sessions)
|
||||
- `per-call`: create a fresh kernel per tool call and shut it down afterward
|
||||
|
||||
Environment override:
|
||||
- `OMP_PY=0|bash` → `bash-only`
|
||||
- `OMP_PY=1|py` → `ipy-only`
|
||||
- `OMP_PY=mix|both` → `both`
|
||||
|
||||
- `PI_PY=0|bash` → `bash-only`
|
||||
- `PI_PY=1|py` → `ipy-only`
|
||||
- `PI_PY=mix|both` → `both`
|
||||
|
||||
## Shell Helper
|
||||
|
||||
@@ -95,9 +102,9 @@ and returns a `ShellResult` with `stdout`, `stderr`, and `code`.
|
||||
## Troubleshooting
|
||||
|
||||
- **Kernel unavailable**: Ensure `python` + `jupyter-kernel-gateway` + `ipykernel` are installed; the session will fall back to bash-only.
|
||||
- **Python mode override**: Check `python.toolMode` or `OMP_PY` if the Python tool is missing.
|
||||
- **Python mode override**: Check `python.toolMode` or `PI_PY` if the Python tool is missing.
|
||||
- **Shared gateway disabled**: `python.sharedGateway=false` causes the Python tool to error because local (per-process) gateways are not supported.
|
||||
- **Skip preflight checks**: Set `OMP_PYTHON_SKIP_CHECK=1` to bypass kernel availability checks.
|
||||
- **External gateway unreachable**: Check the URL is correct and the gateway is running. If auth is required, set `OMP_PYTHON_GATEWAY_TOKEN`.
|
||||
- **IPC tracing**: Set `OMP_PYTHON_IPC_TRACE=1` to log kernel message flow.
|
||||
- **Skip preflight checks**: Set `PI_PYTHON_SKIP_CHECK=1` to bypass kernel availability checks.
|
||||
- **External gateway unreachable**: Check the URL is correct and the gateway is running. If auth is required, set `PI_PYTHON_GATEWAY_TOKEN`.
|
||||
- **IPC tracing**: Set `PI_PYTHON_IPC_TRACE=1` to log kernel message flow.
|
||||
- **Stdin requests**: Interactive input is not supported; refactor code to avoid `input()` or provide data programmatically.
|
||||
|
||||
Reference in New Issue
Block a user