import type { EnvironmentId, ProviderInstanceId, ThreadId } from "@t3tools/contracts";
export interface McpProviderSessionConfig {
readonly environmentId: EnvironmentId;
readonly threadId: ThreadId;
readonly providerSessionId: string;
readonly providerInstanceId: ProviderInstanceId;
readonly endpoint: string;
readonly authorizationHeader: string;
/** Omit preview_* instructions when the user withholds agent browser access. */
readonly browserToolsAvailable: boolean;
readonly capabilities?: ReadonlySet<string>;
readonly agentDeviceEnvironment?: Readonly<Record<string, string>>;
}
export function withAgentDeviceEnvironment(
base: NodeJS.ProcessEnv,
config: Pick<McpProviderSessionConfig, "agentDeviceEnvironment"> | undefined,
): NodeJS.ProcessEnv {
const extra = config?.agentDeviceEnvironment;
if (!extra) return base;
const separator = extra.PATH_SEPARATOR ?? ":";
const basePath = base.PATH ?? base.Path;
const { PATH: shimDir, PATH_SEPARATOR: _separator, ...rest } = extra;
return {
...base,
...rest,
...(shimDir ? { PATH: basePath ? `${shimDir}${separator}${basePath}` : shimDir } : {}),
};
}