agent-ecosystem/src/main/services/team/runtimeTeammateMode.ts
2026-05-06 17:34:01 +03:00

99 lines
2.7 KiB
TypeScript

import { isTmuxRuntimeReadyForCurrentPlatform } from '@features/tmux-installer/main';
import { parseCliArgs } from '@shared/utils/cliArgsParser';
interface DesktopTeammateModeDecision {
injectedTeammateMode: 'tmux' | null;
forceProcessTeammates: boolean;
}
let tmuxAvailablePromise: Promise<boolean> | null = null;
function getExplicitTeammateMode(
rawExtraCliArgs: string | undefined
): 'auto' | 'tmux' | 'in-process' | null {
const tokens = parseCliArgs(rawExtraCliArgs);
for (let i = 0; i < tokens.length; i += 1) {
const token = tokens[i];
// eslint-disable-next-line security/detect-possible-timing-attacks -- parsing user-supplied CLI flags, not comparing secrets
if (token === '--teammate-mode') {
const next = tokens[i + 1];
if (next === 'auto' || next === 'tmux' || next === 'in-process') {
return next;
}
return null;
}
if (token.startsWith('--teammate-mode=')) {
const value = token.slice('--teammate-mode='.length);
if (value === 'auto' || value === 'tmux' || value === 'in-process') {
return value;
}
return null;
}
}
return null;
}
async function isTmuxAvailable(): Promise<boolean> {
if (!tmuxAvailablePromise) {
tmuxAvailablePromise = isTmuxRuntimeReadyForCurrentPlatform()
.then((value) => value)
.catch(() => false)
.finally(() => {
tmuxAvailablePromise = null;
});
}
return tmuxAvailablePromise;
}
export async function resolveDesktopTeammateModeDecision(
rawExtraCliArgs: string | undefined
): Promise<DesktopTeammateModeDecision> {
const explicitMode = getExplicitTeammateMode(rawExtraCliArgs);
if (explicitMode === 'tmux') {
return {
injectedTeammateMode: null,
forceProcessTeammates: true,
};
}
if (explicitMode === 'auto') {
return {
injectedTeammateMode: null,
forceProcessTeammates: true,
};
}
if (explicitMode === 'in-process') {
return {
injectedTeammateMode: null,
forceProcessTeammates: false,
};
}
await isTmuxAvailable();
return {
injectedTeammateMode: null,
forceProcessTeammates: true,
};
}
export function applyDesktopTeammateModeDecisionToEnv(
env: NodeJS.ProcessEnv,
decision: Pick<DesktopTeammateModeDecision, 'forceProcessTeammates'>
): void {
if (decision.forceProcessTeammates) {
env.CLAUDE_TEAM_FORCE_PROCESS_TEAMMATES = '1';
return;
}
delete env.CLAUDE_TEAM_FORCE_PROCESS_TEAMMATES;
}
export function buildDesktopTeammateModeCliArgs(
decision: Pick<DesktopTeammateModeDecision, 'injectedTeammateMode'>
): string[] {
return decision.injectedTeammateMode ? ['--teammate-mode', decision.injectedTeammateMode] : [];
}