Skip to content

Interface: SessionEnvironmentResult

Makaio Framework


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

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

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:62

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:68

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:73

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:82

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

Credential env takes precedence over base env so that rotated secrets are not masked by stale process-level values. Binary env then wins over credential env to enforce config isolation.