Files
waggle-os/packages/agent/src/external-process-env.ts
Oleg Maslov b20b138fe4 moving
2026-09-02 10:14:22 +02:00

71 lines
2.8 KiB
TypeScript

import { mergePathValue, resolvedShellPath } from './shell-env.js';
/**
* Non-secret host context required to start CLI and desktop processes.
* Unknown variables are omitted so newly added provider or infrastructure
* credentials cannot silently cross the external-process boundary.
*/
const BASE_ENV_ALLOWLIST = new Set([
'PATH', 'PATHEXT', 'SYSTEMROOT', 'WINDIR', 'SYSTEMDRIVE', 'COMSPEC',
'HOME', 'USERPROFILE', 'HOMEDRIVE', 'HOMEPATH', 'USER', 'USERNAME',
'LOGNAME', 'SHELL',
'APPDATA', 'LOCALAPPDATA', 'HERMES_HOME', 'PROGRAMDATA', 'PROGRAMFILES',
'PROGRAMFILES(X86)', 'PROGRAMW6432',
'TEMP', 'TMP', 'TMPDIR',
'LANG', 'LANGUAGE', 'LC_ALL', 'LC_ADDRESS', 'LC_COLLATE', 'LC_CTYPE',
'LC_IDENTIFICATION', 'LC_MEASUREMENT', 'LC_MESSAGES', 'LC_MONETARY',
'LC_NAME', 'LC_NUMERIC', 'LC_PAPER', 'LC_TELEPHONE', 'LC_TIME',
'TERM', 'COLORTERM',
'TERM_PROGRAM', 'TERM_PROGRAM_VERSION', 'TZ',
'OS', 'PROCESSOR_ARCHITECTURE', 'PROCESSOR_IDENTIFIER',
'NUMBER_OF_PROCESSORS',
'DISPLAY', 'WAYLAND_DISPLAY', 'XAUTHORITY', 'DBUS_SESSION_BUS_ADDRESS',
'XDG_RUNTIME_DIR', 'XDG_CONFIG_HOME', 'XDG_DATA_HOME', 'XDG_CACHE_HOME',
'XDG_STATE_HOME', 'XDG_SESSION_TYPE', 'XDG_CURRENT_DESKTOP',
'DESKTOP_SESSION', '__CF_USER_TEXT_ENCODING',
]);
/** Explicit Waggle runtime metadata constructed by trusted launch code. */
const WAGGLE_ENV_ALLOWLIST = new Set([
'WAGGLE_WORKSPACE_ID', 'WAGGLE_WORKSPACE_PATH',
'WAGGLE_RUN_ID', 'WAGGLE_ROOM_ID', 'WAGGLE_SENDER_ID',
'WAGGLE_DANCE_TEAM_ID', 'WAGGLE_DANCE_URL', 'WAGGLE_RUN_TOKEN',
'WAGGLE_CLI_NODE_PATH', 'WAGGLE_CLI_ENTRY',
'WAGGLE_SIGNAL_EMIT', 'WAGGLE_SIDECAR_URL',
'WAGGLE_HOOK_NODE_PATH', 'HIVE_MIND_DATA_DIR', 'NO_COLOR',
]);
/**
* Build a fail-closed environment for user-installed AI tools and hook bins.
* Provider keys, credential helpers, proxy credentials, infrastructure
* secrets, and arbitrary ambient variables are never inherited. The caller
* may add only the narrow Waggle metadata enumerated above.
*/
export function buildExternalProcessEnv(
base: NodeJS.ProcessEnv,
waggleEnv: NodeJS.ProcessEnv = {},
platform: NodeJS.Platform = process.platform,
): NodeJS.ProcessEnv {
const env: NodeJS.ProcessEnv = {};
for (const [key, value] of Object.entries(base)) {
const upper = key.toUpperCase();
if (value !== undefined && BASE_ENV_ALLOWLIST.has(upper)) {
env[key] = value;
}
}
// GUI-launched POSIX sidecars can inherit a bare PATH. Preserve the existing
// login-shell recovery without importing any other shell variables.
if (platform !== 'win32') {
const shellPath = resolvedShellPath();
if (shellPath) env.PATH = mergePathValue(shellPath, env.PATH);
}
for (const [key, value] of Object.entries(waggleEnv)) {
if (value !== undefined && WAGGLE_ENV_ALLOWLIST.has(key.toUpperCase())) {
env[key] = value;
}
}
return env;
}