| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980 |
- """Private bootstrap policy for admission-owned workers: the frozen session config every
- config reader returns, plus (troubleshooting workers only) the safe/ignore-user-config bypass.
- Stdlib-only: hermes_cli's config/env layer imports it, so it ships in the installer's
- hermes_cli + i18n-kernel tail and must never import beyond the standard library.
- Bind once in a fresh exec, before config/agent/plugin imports. This is not a
- sandbox or a public launch switch: only the managed worker bootstrap consumes
- the owner's validated assignment. No environment flag grants this policy and
- no reset exists; helper threads see the same immutable snapshot.
- """
- from dataclasses import dataclass
- import json
- import os
- import sys
- from threading import Lock
- @dataclass(frozen=True, slots=True)
- class _SafeWorkerPolicy:
- pid: int
- safe_mode: bool
- ignore_user_config: bool
- config_json: str
- _policy: _SafeWorkerPolicy | None = None
- _bind_lock = Lock()
- _RUNTIME_IMPORTS = frozenset({
- "run_agent", "model_tools", "hermes_cli.config", "hermes_cli.env_loader",
- "hermes_cli.plugins", "providers", "agent.agent_init",
- })
- def _bind_safe_worker_policy(*, safe_mode: bool, ignore_user_config: bool,
- config: dict) -> _SafeWorkerPolicy:
- """Called by the private worker bootstrap, never by the owner or public CLI."""
- if type(safe_mode) is not bool or type(ignore_user_config) is not bool:
- raise TypeError("worker bypass policy fields must be booleans")
- if not (safe_mode or ignore_user_config):
- raise ValueError("ordinary execution binds its config with _bind_worker_config")
- return _bind(safe_mode, True, config)
- def _bind_worker_config(config: dict) -> _SafeWorkerPolicy:
- """An ordinary managed worker's frozen session config: every config reader returns it (the
- session never follows later profile edits), while plugins, MCP, hooks and providers load as
- usual — ``safe_worker_enabled()`` stays False. Same one-shot, pre-import rules as bypass."""
- return _bind(False, False, config)
- def _bind(safe_mode: bool, ignore_user_config: bool, config: dict) -> _SafeWorkerPolicy:
- global _policy
- if type(config) is not dict:
- raise TypeError("worker config must be a JSON object")
- serialized = json.dumps(config, allow_nan=False)
- with _bind_lock:
- if _policy is not None:
- raise RuntimeError("worker policy is already bound")
- if _RUNTIME_IMPORTS.intersection(sys.modules):
- raise RuntimeError("worker policy must bind before runtime imports")
- _policy = _SafeWorkerPolicy(os.getpid(), safe_mode, ignore_user_config, serialized)
- return _policy
- def _current_policy() -> _SafeWorkerPolicy | None:
- if _policy is not None and _policy.pid != os.getpid():
- raise RuntimeError("worker policy cannot cross a fork; use a fresh exec")
- return _policy
- def safe_worker_enabled() -> bool:
- policy = _current_policy()
- return policy is not None and policy.safe_mode
- def worker_config_snapshot() -> dict | None:
- """Return detached explicit config; None means the ordinary loader owns it."""
- policy = _current_policy()
- return json.loads(policy.config_json) if policy is not None else None
|