Function runSetupCommands

services/cloud-agent-next/src/session-service.ts:702–794

(
  session: ExecutionSession,
  context: SessionContext,
  setupCommands: string[],
  failFast: boolean = false,
  options: RunSetupCommandsOptions = {}
)

 * @param setupCommands - Array of setup commands to execute
 * @param failFast - Whether to stop on first failure (default: false)
 */
type RunSetupCommandsOptions = {
  devcontainer?: DevContainerHandle;
  dockerEnv?: Record<string, string>;
  runtimeEnv?: Record<string, string | undefined>;
};

function buildSetupEnvFileContent(env: Record<string, string | undefined>): string {
  return `${validShellEnvEntries(env)
    .map(([key, value]) => `export ${key}=${shellQuote(value)}`)
    .join('\n')}\n`;
}

function buildDevContainerSetupCommand(
  devcontainer: DevContainerHandle,
  command: string,
  envFilePath: string | undefined
): string {
  const workspaceCommand = `cd ${shellQuote(devcontainer.innerWorkspaceFolder)} && ${command}`;
  const innerCommand = envFilePath
    ? `. ${shellQuote(envFilePath)} && ${workspaceCommand}`
    : workspaceCommand;
  return [
    'devcontainer exec',
    `--workspace-folder ${shellQuote(devcontainer.workspacePath)}`,
    `--config ${shellQuote(devcontainer.overrideConfigPath)}`,
    `--id-label ${shellQuote(`${KILO_AGENT_SESSION_LABEL}=${devcontainer.agentSessionId}`)}`,
    '--',
    'sh -c',
    shellQuote(innerCommand),
  ].join(' ');
}

export async function runSetupCommands(
  session: ExecutionSession,
  context: SessionContext,
  setupCommands: string[],
  failFast: boolean = false,
  options: RunSetupCommandsOptions = {}
): Promise<void> {
  if (!setupCommands || setupCommands.length === 0) {
    return;
  }

  const dockerEnv = options.devcontainer
    ? (options.dockerEnv ?? dockerSocketEnv(await resolveDockerSocketPath(session)))
    : undefined;
  const setupEnvFilePath =
    options.devcontainer && options.runtimeEnv
      ? `${context.sessionHome}/tmp/kilo-setup-env-${options.devcontainer.agentSessionId}-${Date.now()}.sh`
      : undefined;

  if (setupEnvFilePath && options.runtimeEnv) {
    await session.writeFile(setupEnvFilePath, buildSetupEnvFileContent(options.runtimeEnv));
  }

  logger.setTags({ setupCommandsCount: setupCommands.length });
  logger.info('Running setup commands');