Skip to content

Interface: SessionEnvironmentResult

Makaio Framework


Makaio Framework / ai-adapters-core/config / SessionEnvironmentResult

Defined in: ../../../adapters/core/src/config/resolve-session-environment.ts:64

Fully resolved session environment returned by resolveSessionEnvironment.

All three resolution steps are returned individually so callers that need non-standard composition (e.g. optional binary env) can do so without repeating the resolution calls.

credentials: Record<string, string>

Defined in: ../../../adapters/core/src/config/resolve-session-environment.ts:69

Plaintext credentials keyed by field name. Empty when providerContext is undefined or carries no credential refs.


credEnv: Record<string, string>

Defined in: ../../../adapters/core/src/config/resolve-session-environment.ts:75

Environment variables derived from credentials via the provider’s credentialEnvVars mapping. Empty when providerContext is undefined or carries no credentialEnvVars.


resolvedBinary: { binaryPath: string | null; configDir: string | null; env: Record<string, string>; source: "global" | "managed"; version: string | null; } | undefined

Defined in: ../../../adapters/core/src/config/resolve-session-environment.ts:80

Execution context for the resolved client binary, or undefined when no client.resolveBinary handler is registered (framework-only boot).

{ binaryPath: string | null; configDir: string | null; env: Record<string, string>; source: "global" | "managed"; version: string | null; }

binaryPath: string | null

Absolute path to the resolved binary, or null when the caller should use PATH default.

configDir: string | null

Absolute path to the config directory the binary will use, or null when no config isolation is active.

env: Record<string, string>

Environment variables to set when spawning the binary.

source: "global" | "managed"

Where the binary was resolved from.

version: string | null

Resolved version string, or null when unknown.


undefined


spawnEnv: Record<string, string>

Defined in: ../../../adapters/core/src/config/resolve-session-environment.ts:90

Merged spawn environment for the common case: { ...cleanBaseEnv, ...credEnv, ...(resolvedBinary?.env ?? {}) }.

Ambient provider credential env vars are stripped from base env first. Credential env then takes precedence so that explicitly resolved secrets are restored. Binary env finally wins over credential env to enforce config isolation.