@wjarka/cezarion 0.10.0-pr30.54

package/dist/core/agent-env.js

@@ -0,0 +1,371 @@
+/**
+ * Least-privilege environment for spawned agent backends (#427).
+ *
+ * Every backend used to inherit the FULL parent environment
+ * (`{ ...process.env, ...spec.env }`), handing `GITHUB_TOKEN`,
+ * `ANTHROPIC_API_KEY`, `AWS_*` and any other host secret to a process an
+ * attacker-controlled prompt can drive. Instead we build an explicit,
+ * curated child env: a base allowlist of the non-secret vars a shell / dev
+ * toolchain genuinely needs, plus the specific auth vars the chosen backend
+ * requires, plus cezar's own `CEZ_*` namespace and the per-run `spec.env`.
+ * Everything else — notably arbitrary secrets — is dropped by default.
+ *
+ * Zero-config: the safe env is the default and needs no configuration. Two
+ * opt-in escape hatches (both read from the host env, both off by default):
+ *   - `CEZ_ENV_PASSTHROUGH=A,B,C` forwards those extra named vars;
+ *   - `CEZ_AGENT_ENV_FULL=1` restores the legacy full-`process.env` behavior.
+ */
+import { SECRET_NAME_RE } from './secret-redaction.js';
+/**
+ * Env var names are matched case-INSENSITIVELY (#427 review). Windows spells
+ * the essentials `Path`, `SystemRoot`, `ComSpec`, `windir` — an exact-case
+ * `Set.has('PATH')` matched none of them, so every child env on win32 came out
+ * with no PATH and the backend binary could not even be resolved. The child env
+ * still carries each var under the parent's ORIGINAL spelling: Windows tooling
+ * expects `Path`, and normalizing the key would break it just as badly.
+ */
+function upperSet(names) {
+    return new Set(names.map((n) => n.toUpperCase()));
+}
+/** Exact var names always forwarded — non-secret, needed by shells/tools. */
+const BASE_ALLOW_NAMES = upperSet([
+    // Core shell / process identity
+    'PATH',
+    'HOME',
+    'SHELL',
+    'USER',
+    'LOGNAME',
+    'LNAME',
+    'PWD',
+    'OLDPWD',
+    'SHLVL',
+    'HOSTNAME',
+    'HOST',
+    'HOSTTYPE',
+    'MACHTYPE',
+    'OSTYPE',
+    'TMPDIR',
+    'TEMP',
+    'TMP',
+    'TZ',
+    // Locale
+    'LANG',
+    'LANGUAGE',
+    // Terminal / display
+    'TERM',
+    'TERMINFO',
+    'COLORTERM',
+    'COLUMNS',
+    'LINES',
+    'CLICOLOR',
+    'FORCE_COLOR',
+    'NO_COLOR',
+    'DISPLAY',
+    'WAYLAND_DISPLAY',
+    'XAUTHORITY',
+    // ssh agent socket/pid — a path + pid, not a credential (git over ssh)
+    'SSH_AUTH_SOCK',
+    'SSH_AGENT_PID',
+    // Editors / pagers
+    'EDITOR',
+    'VISUAL',
+    'PAGER',
+    'LESS',
+    'MANPATH',
+    'INFOPATH',
+    // Git plumbing that is not a secret
+    'GIT_PAGER',
+    'GIT_EDITOR',
+    'GIT_TERMINAL_PROMPT',
+    'GIT_SSH',
+    'GIT_SSH_COMMAND',
+    'GIT_EXEC_PATH',
+    // Proxies (matching is case-insensitive, so `http_proxy` is covered too)
+    'HTTP_PROXY',
+    'HTTPS_PROXY',
+    'FTP_PROXY',
+    'ALL_PROXY',
+    'NO_PROXY',
+    // Windows equivalents of the above. Without these `nodeSpawn('claude', …)`
+    // cannot resolve or launch the binary at all on win32 — the platform is
+    // supported (open-in-terminal.ts, open-in-app.ts, process-usage.ts) and
+    // package.json carries no `os` restriction. `HOME` is normally unset there;
+    // `USERPROFILE` is its counterpart.
+    'SYSTEMROOT',
+    'SYSTEMDRIVE',
+    'WINDIR',
+    'COMSPEC',
+    'PATHEXT',
+    'USERPROFILE',
+    'HOMEDRIVE',
+    'HOMEPATH',
+    'APPDATA',
+    'LOCALAPPDATA',
+    'PROGRAMDATA',
+    'ALLUSERSPROFILE',
+    'PUBLIC',
+    'PROGRAMFILES',
+    'PROGRAMFILES(X86)',
+    'PROGRAMW6432',
+    'COMMONPROGRAMFILES',
+    'COMMONPROGRAMFILES(X86)',
+    'COMMONPROGRAMW6432',
+    'PSMODULEPATH',
+    'USERNAME',
+    'USERDOMAIN',
+    'COMPUTERNAME',
+    'LOGONSERVER',
+    'SESSIONNAME',
+    'OS',
+    'NUMBER_OF_PROCESSORS',
+    'PROCESSOR_ARCHITECTURE',
+    'PROCESSOR_IDENTIFIER',
+    'PROCESSOR_LEVEL',
+    'PROCESSOR_REVISION',
+]);
+/** Safe prefix families — dev toolchains that agents drive (node, python,
+ *  rust, go, java, …). A name here still drops if it matches a secret
+ *  pattern (e.g. `NODE_AUTH_TOKEN`, `CARGO_REGISTRY_TOKEN`). */
+const BASE_ALLOW_PREFIXES = [
+    'LC_',
+    'XDG_',
+    'LESS_',
+    // Node / JS
+    'NODE_',
+    'NPM_CONFIG_',
+    'NVM_',
+    'PNPM_',
+    'YARN_',
+    'BUN_',
+    'DENO_',
+    'VOLTA_',
+    'FNM_',
+    'COREPACK_',
+    // Python
+    'PYENV',
+    'PYTHON',
+    'PIP_',
+    'PIPENV_',
+    'POETRY_',
+    'VIRTUAL_ENV',
+    'CONDA_',
+    'UV_',
+    // Ruby
+    'RBENV',
+    'RUBY',
+    'GEM_',
+    'BUNDLE_',
+    // Rust
+    'RUSTUP_',
+    'CARGO_',
+    'RUST_',
+    // Go
+    'GOPATH',
+    'GOROOT',
+    'GOBIN',
+    'GOCACHE',
+    'GOMODCACHE',
+    'GOFLAGS',
+    'GOPROXY',
+    'GOPRIVATE',
+    'GOTOOLCHAIN',
+    'GOOS',
+    'GOARCH',
+    'GOENV',
+    'GOWORK',
+    'GO111MODULE',
+    // JVM / Android / Kotlin
+    'JAVA',
+    'JDK_',
+    'MAVEN_',
+    'GRADLE_',
+    'KOTLIN_',
+    'ANDROID_',
+    'SDKMAN_',
+    // .NET / other
+    'DOTNET_',
+    'NUGET_',
+    'SWIFT',
+    'XCODE',
+    'HOMEBREW_',
+    'ASDF_',
+    'MISE_',
+    'COMPOSER_',
+];
+/** The provider credentials a backend that selects models as `provider/model` may need — it can
+ *  be pointed at any of them, so none can be pruned without breaking a legitimate model id. */
+const MULTI_PROVIDER_PREFIXES = [
+    'OPENAI_',
+    'ANTHROPIC_',
+    'AZURE_OPENAI_',
+    'OPENROUTER_',
+    'GROQ_',
+    'MISTRAL_',
+    'GEMINI_',
+    'GOOGLE_GENERATIVE_AI_',
+    'DEEPSEEK_',
+    'XAI_',
+    'PERPLEXITY_',
+    'TOGETHER_',
+    'FIREWORKS_',
+];
+/** Per-backend auth/config the runner genuinely needs, by prefix. */
+const BACKEND_ALLOW_PREFIXES = {
+    claude: ['ANTHROPIC_', 'CLAUDE_'],
+    'claude-cli': ['ANTHROPIC_', 'CLAUDE_'],
+    codex: ['OPENAI_', 'CODEX_', 'AZURE_OPENAI_'],
+    opencode: MULTI_PROVIDER_PREFIXES,
+    // pi selects models as `provider/model` (#387), so it needs both its own config and any
+    // provider a configured model id can name — the same set OpenCode gets, for the same reason.
+    // Deliberately NOT `CLAUDE_`: pi is not Claude Code and reads none of its variables, and the
+    // prefix is load-bearing below — it is what unlocks the Bedrock/Vertex cloud credentials, so
+    // granting it here handed pi the whole `AWS_*` / `GOOGLE_CLOUD_*` family on any host that had
+    // set `CLAUDE_CODE_USE_BEDROCK=1` for Claude Code, plus Claude's own config dir.
+    pi: ['PI_', ...MULTI_PROVIDER_PREFIXES],
+};
+/** `gh` handoff (draft PRs) works in every backend — the one credential the
+ *  project deliberately keeps in the environment (AGENTS.md "No secrets in
+ *  state files": GITHUB_TOKEN stays in env, never on disk). */
+const GH_ALLOW_NAMES = upperSet([
+    'GITHUB_TOKEN',
+    'GH_TOKEN',
+    'GH_HOST',
+    'GH_ENTERPRISE_TOKEN',
+    'GH_CONFIG_DIR',
+]);
+/**
+ * Claude Code can be pointed at Bedrock or Vertex instead of the Anthropic API
+ * by `CLAUDE_CODE_USE_BEDROCK=1` / `CLAUDE_CODE_USE_VERTEX=1`. Those toggles
+ * ride in on the `CLAUDE_` prefix — but the cloud credentials they switch the
+ * SDK over to did not, so hardening the env forwarded the *instruction* to use
+ * Bedrock while dropping the *means*, turning a working setup into a hard auth
+ * failure with no hint (#427 review). Each toggle therefore unlocks exactly the
+ * credentials its own path needs, and only while it is on: with no toggle set
+ * (the default, direct-API posture) `AWS_*` / `GOOGLE_*` stay dropped, which is
+ * the least-privilege behavior #427 asked for in the first place.
+ */
+const BEDROCK_TOGGLE = 'CLAUDE_CODE_USE_BEDROCK';
+const VERTEX_TOGGLE = 'CLAUDE_CODE_USE_VERTEX';
+/** The whole `AWS_` family: the SDK's credential chain reads far more than the
+ *  static keys (SSO/profile/container/web-identity all have their own vars). */
+const BEDROCK_ALLOW_PREFIXES = ['AWS_'];
+const VERTEX_ALLOW_NAMES = upperSet([
+    'GOOGLE_APPLICATION_CREDENTIALS',
+    'CLOUD_ML_REGION',
+    // ANTHROPIC_VERTEX_PROJECT_ID already rides in on the `ANTHROPIC_` prefix.
+]);
+const VERTEX_ALLOW_PREFIXES = ['GOOGLE_CLOUD_'];
+export function looksSecret(name) {
+    return SECRET_NAME_RE.test(name);
+}
+/** Prefixes are authored uppercase; `name` must already be normalized. */
+function matchesPrefix(name, prefixes) {
+    return prefixes.some((p) => name.startsWith(p));
+}
+/** Case-insensitive read of `source` — a win32 fixture may spell it `Path`. */
+function readVar(source, name) {
+    const direct = source[name];
+    if (direct !== undefined)
+        return direct;
+    const upper = name.toUpperCase();
+    for (const [k, v] of Object.entries(source)) {
+        if (k.toUpperCase() === upper)
+            return v;
+    }
+    return undefined;
+}
+/** An opt-in toggle is on unless it is absent/empty/`0`/`false`. */
+function isTruthy(value) {
+    if (value === undefined)
+        return false;
+    const v = value.trim().toLowerCase();
+    return v !== '' && v !== '0' && v !== 'false';
+}
+/**
+ * Build the curated child environment for a spawned backend. `extraEnv`
+ * (the runner's `spec.env`) is applied last so per-run vars always win.
+ */
+export function buildChildEnv(opts) {
+    const source = opts.source ?? process.env;
+    const extra = opts.extraEnv ?? {};
+    // Names `extra` is about to define, normalized. The host copy of a var the
+    // per-run env overrides must be DROPPED, not merely shadowed: env names are
+    // matched case-insensitively here (and by Windows itself), so a host `Temp`
+    // and a per-run `TEMP` are the same variable spelled two ways — leaving both
+    // in the child env hands the backend the host value under one of them. That
+    // is exactly the temp-directory bug #785 fixes, so the override has to be
+    // total. `extra` is cezar's own, never a host secret, and always wins.
+    const overridden = upperSet(Object.keys(extra));
+    // Escape hatch: restore legacy full-inheritance (opt-in, off by default).
+    // Parsed with the same `isTruthy` the Bedrock/Vertex toggles use (#456
+    // review) — an exact `=== '1'` made `CEZ_AGENT_ENV_FULL=true` silently do
+    // nothing, which is a confusing way to fail open-vs-closed.
+    if (isTruthy(readVar(source, 'CEZ_AGENT_ENV_FULL'))) {
+        const full = {};
+        for (const [name, value] of Object.entries(source)) {
+            if (!overridden.has(name.toUpperCase()))
+                full[name] = value;
+        }
+        return { ...full, ...extra };
+    }
+    const backendPrefixes = BACKEND_ALLOW_PREFIXES[opts.backend] ?? BACKEND_ALLOW_PREFIXES.claude;
+    const passthrough = upperSet((readVar(source, 'CEZ_ENV_PASSTHROUGH') ?? '')
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean));
+    // Cloud auth is unlocked only by the toggle that needs it, and only for a
+    // backend that is actually given the toggle (`CLAUDE_` prefix) to read.
+    const claudeCloud = backendPrefixes.includes('CLAUDE_');
+    const cloudPrefixes = [];
+    const cloudNames = new Set();
+    if (claudeCloud && isTruthy(readVar(source, BEDROCK_TOGGLE))) {
+        cloudPrefixes.push(...BEDROCK_ALLOW_PREFIXES);
+    }
+    if (claudeCloud && isTruthy(readVar(source, VERTEX_TOGGLE))) {
+        cloudPrefixes.push(...VERTEX_ALLOW_PREFIXES);
+        for (const n of VERTEX_ALLOW_NAMES)
+            cloudNames.add(n);
+    }
+    const out = {};
+    for (const [name, value] of Object.entries(source)) {
+        if (value === undefined)
+            continue;
+        if (overridden.has(name.toUpperCase()))
+            continue; // the per-run value replaces it, whatever the spelling
+        if (allow(name))
+            out[name] = value;
+    }
+    // Per-run env last — it is cezar's own, never a host secret, and must win.
+    for (const [name, value] of Object.entries(extra))
+        out[name] = value;
+    return out;
+    /** `name` is matched normalized; the caller keeps the original spelling. */
+    function allow(name) {
+        const key = name.toUpperCase();
+        // cezar's own namespace (CEZ_DRY_RUN plumbing, mock hooks, run wiring).
+        if (key.startsWith('CEZ_'))
+            return true;
+        // Backend auth + gh handoff + the cloud creds an active Bedrock/Vertex
+        // toggle needs: forwarded even though they are secrets — the backend cannot
+        // authenticate without them. They are still redacted before anything
+        // reaches the on-disk NDJSON (see secret-redaction.ts).
+        if (GH_ALLOW_NAMES.has(key))
+            return true;
+        if (matchesPrefix(key, backendPrefixes))
+            return true;
+        if (cloudNames.has(key) || matchesPrefix(key, cloudPrefixes))
+            return true;
+        // Explicit opt-in passthrough.
+        if (passthrough.has(key))
+            return true;
+        // Base allowlist — exact names always, prefix families only when the name
+        // is not itself credential-shaped (`NODE_AUTH_TOKEN` never rides in on
+        // `NODE_`, in either spelling — looksSecret sees the normalized name).
+        if (BASE_ALLOW_NAMES.has(key))
+            return true;
+        if (matchesPrefix(key, BASE_ALLOW_PREFIXES) && !looksSecret(key))
+            return true;
+        return false;
+    }
+}
+//# sourceMappingURL=agent-env.js.map

package/dist/core/agent-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-env.js","sourceRoot":"","sources":["../../src/core/agent-env.ts"],"names":[],"mappings":"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"}

package/dist/core/agent-model-policy.d.ts

@@ -0,0 +1,10 @@
+/** The server-side switch that makes native agent settings authoritative. */
+export declare const AGENT_MODELS_LOCKED_ENV = "CEZ_AGENT_MODELS_LOCKED";
+/**
+ * Only the exact environment value `1` enables the process-wide lock. The
+ * global workspace config or one repository may additionally opt in with
+ * `"modelsLocked": true`; missing, unreadable, malformed, and false values
+ * preserve ordinary model selection unless another source enables the lock.
+ */
+export declare function agentModelsLocked(repoRoot?: string, env?: NodeJS.ProcessEnv): boolean;
+export declare const AGENT_MODELS_LOCKED_ERROR = "agent models are locked \u2014 configure the model in the native coding-agent settings";

package/dist/core/agent-model-policy.js

@@ -0,0 +1,36 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { workspaceConfigPath } from '../paths.js';
+/** The server-side switch that makes native agent settings authoritative. */
+export const AGENT_MODELS_LOCKED_ENV = 'CEZ_AGENT_MODELS_LOCKED';
+const modelPolicyConfigSchema = z.object({
+    modelsLocked: z.boolean().optional(),
+}).passthrough();
+/**
+ * Only the exact environment value `1` enables the process-wide lock. The
+ * global workspace config or one repository may additionally opt in with
+ * `"modelsLocked": true`; missing, unreadable, malformed, and false values
+ * preserve ordinary model selection unless another source enables the lock.
+ */
+export function agentModelsLocked(repoRoot, env = process.env) {
+    if (env[AGENT_MODELS_LOCKED_ENV] === '1')
+        return true;
+    const paths = [
+        workspaceConfigPath(env),
+        ...(repoRoot ? [join(repoRoot, '.ai', 'cezar', 'config.json')] : []),
+    ];
+    for (const path of paths) {
+        try {
+            const parsed = modelPolicyConfigSchema.safeParse(JSON.parse(readFileSync(path, 'utf8')));
+            if (parsed.success && parsed.data.modelsLocked === true)
+                return true;
+        }
+        catch {
+            // Each source is optional and independently degradable.
+        }
+    }
+    return false;
+}
+export const AGENT_MODELS_LOCKED_ERROR = 'agent models are locked — configure the model in the native coding-agent settings';
+//# sourceMappingURL=agent-model-policy.js.map

package/dist/core/agent-model-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-model-policy.js","sourceRoot":"","sources":["../../src/core/agent-model-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AAEjE,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC,WAAW,EAAE,CAAC;AAEjB;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAiB,EACjB,GAAG,GAAsB,OAAO,CAAC,GAAG;IAEpC,IAAI,GAAG,CAAC,uBAAuB,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,KAAK,GAAG;QACZ,mBAAmB,CAAC,GAAG,CAAC;QACxB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAC9C,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CACvC,CAAC;YACF,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GACpC,mFAAmF,CAAC"}

package/dist/core/agent-profiles.d.ts

@@ -0,0 +1,62 @@
+import type { ProviderId } from './provider-auth.ts';
+/**
+ * Agent profiles — a second (third, …) login of the SAME agent CLI.
+ *
+ * The binary never changes; only the environment does. `CLAUDE_CONFIG_DIR=~/.claude-klaudiusz claude`
+ * is the same Claude Code talking to a different account, because that one variable relocates the
+ * agent's ENTIRE per-user home: credentials, settings, projects and — the part that bites —
+ * `sessions/`, so a session id only means something inside the dir it was created in.
+ *
+ * This module is the single maintenance surface for that vendor knowledge, and it is deliberately
+ * the SIBLING of `src/agent-config/catalog.ts` rather than part of it: the catalog owns config
+ * *file* knowledge (paths, formats, verbatim precedence strings), this owns the *home-relocation*
+ * variable. Splitting them also keeps the layering honest — `agent-config/` may import `paths.ts`,
+ * while this is imported BY the runners, provider auth and the terminal handoff.
+ *
+ * Pure by construction: no filesystem, no `process.env`, nothing to stub. Resolution against the
+ * workspace config lives in `src/workspace/agent-profiles.ts`.
+ *
+ * Facts verified against the shipped CLIs on 2026-07-29.
+ */
+/**
+ * Which env var relocates each agent's whole per-user home.
+ *
+ * `null` means the agent has no such variable and therefore cannot carry profiles:
+ *
+ * - **claude** → `CLAUDE_CONFIG_DIR`. Documented; moves credentials, settings, projects, sessions.
+ * - **codex** → `CODEX_HOME`. Documented; `auth.json` lives inside it, so identity moves too.
+ * - **opencode** → nothing usable. `OPENCODE_CONFIG_DIR`/`OPENCODE_CONFIG` move CONFIG ONLY;
+ *   credentials live in `~/.local/share/opencode/opencode.db`, behind a separate `OPENCODE_DB`.
+ *   A config-dir-only profile would swap settings while still billing the other account — the UI
+ *   would say "Work" and the run would not be — so OpenCode is unsupported until it documents a
+ *   single home variable. `XDG_CONFIG_HOME` is rejected regardless: it is machine-wide and would
+ *   relocate every other XDG-aware tool the agent's own Bash calls touch.
+ * - **pi** → nothing documented. pi ships no per-user home variable of its own, so — exactly like
+ *   OpenCode — a second account cannot be carried without silently billing the wrong one. `null`
+ *   until pi documents a single home variable that moves credentials as well as config.
+ */
+export declare const PROFILE_ENV_VAR: Record<ProviderId, string | null>;
+/** Providers that can carry more than one account — what the UI offers "Add account" for. */
+export declare const PROFILE_CAPABLE_PROVIDERS: readonly ProviderId[];
+export declare function supportsProfiles(provider: ProviderId): boolean;
+/**
+ * The env a spawned agent needs to run under `configDir`, or `{}` for the default profile.
+ *
+ * `{}` is load-bearing, not a convenience: `buildChildEnv` applies `extraEnv` AFTER its allowlist
+ * and so bypasses it entirely, which makes this function the only thing standing between a
+ * profile and the child environment. Returning nothing for the zero-config case means the
+ * overwhelmingly common path adds literally no variable — the same environment cezar has always
+ * spawned. It also means this can never emit one provider's variable for another provider's
+ * process: the name comes from `PROFILE_ENV_VAR[provider]` and nowhere else.
+ */
+export declare function profileEnv(provider: ProviderId, configDir: string | null | undefined): Record<string, string>;
+/**
+ * Does `entries` look like a config dir this provider actually wrote?
+ *
+ * ADVISORY, never a gate. The honest first-run flow for a second account is *add the profile →
+ * Connect → the CLI creates the dir on login*, so refusing an unrecognized directory would break
+ * the very case the feature exists for. The answer drives a warning line in the UI, nothing more.
+ *
+ * Takes the directory listing rather than a path so it stays pure; the caller reads the dir.
+ */
+export declare function looksLikeProfileDir(provider: ProviderId, entries: readonly string[]): boolean;

package/dist/core/agent-profiles.js

@@ -0,0 +1,90 @@
+/**
+ * Agent profiles — a second (third, …) login of the SAME agent CLI.
+ *
+ * The binary never changes; only the environment does. `CLAUDE_CONFIG_DIR=~/.claude-klaudiusz claude`
+ * is the same Claude Code talking to a different account, because that one variable relocates the
+ * agent's ENTIRE per-user home: credentials, settings, projects and — the part that bites —
+ * `sessions/`, so a session id only means something inside the dir it was created in.
+ *
+ * This module is the single maintenance surface for that vendor knowledge, and it is deliberately
+ * the SIBLING of `src/agent-config/catalog.ts` rather than part of it: the catalog owns config
+ * *file* knowledge (paths, formats, verbatim precedence strings), this owns the *home-relocation*
+ * variable. Splitting them also keeps the layering honest — `agent-config/` may import `paths.ts`,
+ * while this is imported BY the runners, provider auth and the terminal handoff.
+ *
+ * Pure by construction: no filesystem, no `process.env`, nothing to stub. Resolution against the
+ * workspace config lives in `src/workspace/agent-profiles.ts`.
+ *
+ * Facts verified against the shipped CLIs on 2026-07-29.
+ */
+/**
+ * Which env var relocates each agent's whole per-user home.
+ *
+ * `null` means the agent has no such variable and therefore cannot carry profiles:
+ *
+ * - **claude** → `CLAUDE_CONFIG_DIR`. Documented; moves credentials, settings, projects, sessions.
+ * - **codex** → `CODEX_HOME`. Documented; `auth.json` lives inside it, so identity moves too.
+ * - **opencode** → nothing usable. `OPENCODE_CONFIG_DIR`/`OPENCODE_CONFIG` move CONFIG ONLY;
+ *   credentials live in `~/.local/share/opencode/opencode.db`, behind a separate `OPENCODE_DB`.
+ *   A config-dir-only profile would swap settings while still billing the other account — the UI
+ *   would say "Work" and the run would not be — so OpenCode is unsupported until it documents a
+ *   single home variable. `XDG_CONFIG_HOME` is rejected regardless: it is machine-wide and would
+ *   relocate every other XDG-aware tool the agent's own Bash calls touch.
+ * - **pi** → nothing documented. pi ships no per-user home variable of its own, so — exactly like
+ *   OpenCode — a second account cannot be carried without silently billing the wrong one. `null`
+ *   until pi documents a single home variable that moves credentials as well as config.
+ */
+export const PROFILE_ENV_VAR = {
+    claude: 'CLAUDE_CONFIG_DIR',
+    codex: 'CODEX_HOME',
+    opencode: null,
+    pi: null,
+};
+/** Providers that can carry more than one account — what the UI offers "Add account" for. */
+export const PROFILE_CAPABLE_PROVIDERS = Object.keys(PROFILE_ENV_VAR).filter((provider) => PROFILE_ENV_VAR[provider] !== null);
+export function supportsProfiles(provider) {
+    return PROFILE_ENV_VAR[provider] !== null;
+}
+/**
+ * The env a spawned agent needs to run under `configDir`, or `{}` for the default profile.
+ *
+ * `{}` is load-bearing, not a convenience: `buildChildEnv` applies `extraEnv` AFTER its allowlist
+ * and so bypasses it entirely, which makes this function the only thing standing between a
+ * profile and the child environment. Returning nothing for the zero-config case means the
+ * overwhelmingly common path adds literally no variable — the same environment cezar has always
+ * spawned. It also means this can never emit one provider's variable for another provider's
+ * process: the name comes from `PROFILE_ENV_VAR[provider]` and nowhere else.
+ */
+export function profileEnv(provider, configDir) {
+    const name = PROFILE_ENV_VAR[provider];
+    const dir = configDir?.trim();
+    if (name === null || !dir)
+        return {};
+    return { [name]: dir };
+}
+/**
+ * Does `entries` look like a config dir this provider actually wrote?
+ *
+ * ADVISORY, never a gate. The honest first-run flow for a second account is *add the profile →
+ * Connect → the CLI creates the dir on login*, so refusing an unrecognized directory would break
+ * the very case the feature exists for. The answer drives a warning line in the UI, nothing more.
+ *
+ * Takes the directory listing rather than a path so it stays pure; the caller reads the dir.
+ */
+export function looksLikeProfileDir(provider, entries) {
+    const present = new Set(entries);
+    const markers = PROFILE_DIR_MARKERS[provider];
+    return markers.some((marker) => present.has(marker));
+}
+/** What each agent drops into its home on first login. Any one is enough. */
+const PROFILE_DIR_MARKERS = {
+    // `.claude.json` sits INSIDE the dir once it is overridden (see `claudeStateFilePath`), which
+    // is exactly the case being probed here.
+    claude: ['.claude.json', 'settings.json', 'projects', 'sessions'],
+    codex: ['auth.json', 'config.toml'],
+    opencode: [],
+    // pi cannot carry profiles (`PROFILE_ENV_VAR.pi === null`), so nothing ever probes a pi
+    // profile dir; the entry exists to keep this table exhaustive over `ProviderId`.
+    pi: [],
+};
+//# sourceMappingURL=agent-profiles.js.map

package/dist/core/agent-profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-profiles.js","sourceRoot":"","sources":["../../src/core/agent-profiles.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAsC;IAChE,MAAM,EAAE,mBAAmB;IAC3B,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,IAAI;IACd,EAAE,EAAE,IAAI;CACT,CAAC;AAEF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,yBAAyB,GACpC,MAAM,CAAC,IAAI,CAAC,eAAe,CAC5B,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;AAE3D,MAAM,UAAU,gBAAgB,CAAC,QAAoB;IACnD,OAAO,eAAe,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;AAC5C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,QAAoB,EAAE,SAAoC;IACnF,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;AACzB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAoB,EAAE,OAA0B;IAClF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,6EAA6E;AAC7E,MAAM,mBAAmB,GAA0C;IACjE,8FAA8F;IAC9F,yCAAyC;IACzC,MAAM,EAAE,CAAC,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,CAAC;IACjE,KAAK,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC;IACnC,QAAQ,EAAE,EAAE;IACZ,wFAAwF;IACxF,iFAAiF;IACjF,EAAE,EAAE,EAAE;CACP,CAAC"}