Skip to content

v1.8.3 — Zero-Egress Local Miner Default, Loopback Kestrel Alignment & Security Hardening

Latest

Choose a tag to compare

@equilibrium-eq equilibrium-eq released this 10 Nov 19:42

[1.8.3] - 2026-11-10

Security

  • Zero-Egress Guarantee by Default for Local Miner Mode (local_miner=True / TWEEKIT_MINER_LOCAL=1): _is_local_only_mode() and _assert_outbound_internet_allowed() now automatically enforce zero-cloud-egress semantics whenever TWEEKIT_MINER_LOCAL=1 or TweekitDirectClient(local_miner=True) is active, blocking outbound internet tools (convert_url, fetch, search) by default unless TWEEKIT_ALLOW_REMOTE_FETCH_IN_LOCAL_ONLY=1, TWEEKIT_LOCAL_ONLY=0, or TweekitDirectClient(local_miner=True, allow_remote_fetch=True) is explicitly set.
  • Wildcard Bind Address Rejection (0.0.0.0 / ::) & Loopback Kestrel Alignment: _resolve_api_base_url() and _is_local_or_onprem_api_url() now explicitly reject 0.0.0.0 and :: wildcard bind URLs in TWEEKIT_API_BASE_URL and TWEEKIT_ONPREM_HOSTS, paired with the equilibrium-team/tweekit-api@6727c59 update binding TweekIT_API/appsettings.Release_CloudMaitrix.json to http://127.0.0.1:5000 by default.

[1.8.2] - 2026-11-10

Added

  • On-Premises & Localhost Miner Renderery Support (--local-miner, TWEEKIT_API_BASE_URL, TWEEKIT_LOCAL_ONLY=1): Added first-class support for routing tweekit-mcp and TweekitDirectClient(local_miner=True) to a local or on-premises Miner Renderery (http://127.0.0.1:16377/api/image/ or http://127.0.0.1:5000/api/image/), serving as the last-mile MCP integration for the New Miner Installation Initiative.
  • Zero-Cloud-Egress Enforcement (TWEEKIT_LOCAL_ONLY=1 & TWEEKIT_REQUIRE_LOCAL_MINER_FOR_FILES=1): Guarantees that local workspace files converted via convert_file or convert never leave the host machine or private LAN (TWEEKIT_ONPREM_HOSTS) and blocks outbound internet tools (convert_url, fetch, search) when running in air-gapped local mode.
  • Loopback NOAUTH;NODB Miner Renderery Mode (TWEEKIT_MINER_NOAUTH=1): Allows local stdio MCP sessions and TweekitDirectClient to communicate with a loopback NOAUTH;NODB Miner Renderery without requiring cloud portal API credentials, while forwarding X-CPUCoinMiner-* diagnostic headers.
  • Runtime Mode Introspection Resource (config://tweekit-runtime-mode): Added an MCP resource reporting execution_mode ("onprem-miner-renderery" vs "cloud-cgn"), api_base_url, local_only_zero_egress, and local_files_enabled.
  • On-Premises Miner Renderery Specification & Security Policy: Added docs/onprem-miner-renderery-spec.md, SECURITY.md, glama.json, and smithery.yaml.

Changed

  • Explicit Direct Runtime Dependencies & CI Registry Sync: Declared httpcore>=1.0.9, starlette>=1.7.0 (1.10.0 on Python 3.11+), and uvicorn>=0.54.0 explicitly in pyproject.toml, functions/requirements.txt, and scripts/build_claude_bundle.py, expanded _SENSITIVE_PATH_SEGMENTS to block IDE/agent config directories (.vscode, .idea, .github, .claude, .cursor, .gemini), and updated .github/workflows/publish-mcp.yml to wait for PyPI version propagation (failing closed on timeout) before running mcp-publisher publish.

[1.8.1] - 2026-11-09

Changed (Breaking Security Hardening)

  • Credential-Free MCP Tool Schemas & Atomic HTTP Header Auth: Removed apiKey and apiSecret from all LLM-visible MCP tool schemas (server.py, functions/main.py) and REST JSON request bodies (plugin_proxy.py) so credentials never enter model context or tool-call logs. Callers authenticate via HTTP ApiKey + ApiSecret headers (sent automatically by TweekitClient via StreamableHttpTransport) or TWEEKIT_API_KEY + TWEEKIT_API_SECRET environment variables on local stdio servers.
  • Explicit Workspace Requirement for Local File Conversion (convert_file): Local file access now defaults to TWEEKIT_ALLOW_LOCAL_FILES=0, is unconditionally disabled during HTTP requests, and requires TWEEKIT_ALLOWED_DIRS to be explicitly configured when opted in on stdio.

Security

  • Supply-Chain Dependency Upgrade (0 CVEs): Raised dependency floors to fastmcp>=4.1.6, mcp>=2.3.0, fastapi>=0.162.2, and certifi>=2026.10.23 across pyproject.toml, uv.lock, functions/requirements.txt, and scripts/build_claude_bundle.py, remediating CVE-2026-32871, CVE-2026-27124 (GHSA-rww4-4w9c-7733), GHSA-7xgj-8392-5q4r, and CVE-2025-64340.
  • Connect-Time DNS IP Pinning & SSRF Protections (convert_url, fetch, /convert-url): Enforced https://-only URLs, connect-time IP pinning (_PinnedPublicDNSBackend) preventing DNS-rebinding TOCTOU across initial requests and every redirect hop (max_redirects=5), IPv4/IPv6/NAT64/6to4/Teredo private-range blocking, a 25 MiB streaming download cap, and a non-credential fetchHeaders allowlist.
  • Symlink-Safe Local Sandbox (lstat + O_NOFOLLOW): Unconditionally rejects existing and dangling symlinks on read and write paths (including TWEEKIT_ALLOW_OVERWRITE=1), blocks workspace-relative dotfile/credential paths, enforces safe media/document output extensions, validates docId/inext/outfmt tokens, and binds --host to 127.0.0.1 locally (0.0.0.0 in Cloud Run/Docker) with host_origin_protection="auto".

Fixed

  • Trailing-Slash /mcp/ In-Place Routing & Registry Ownership Markers: Added _NormalizeMcpPathMiddleware and Uvicorn --proxy-headers support so both https://mcp.tweekit.io/mcp and https://mcp.tweekit.io/mcp/ initialize directly (200 OK) without 307 redirects or http:// scheme downgrades, and included both active Official MCP Registry ownership markers (io.github.equilibrium-team/tweekit and io.tweekit/mcp) in README.md.